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NOTICE TO MULTIDOS USERS 

This software is sold on an "as is" basis. Neither 
Cosmopolitan Electronics Corporation nor AlphaBit 
Communications, Inc. shall not be liable or responsible 
to the purchaser with respect to liability, loss, or 
damage caused or alleged to be caused directly or 
indirectly by the use of this software, which includes 
but is not limited to any interruption of service, loss 
of business, c anticipatory profits, or consequential 
damage resulting from use of this software. 



Throughout this manual references are made to trademarked 
products. The (tm) symbol is used once here to serve throughout 
the manual. 



DBLDOS (tm) 
DOS PLUS (tm) 
LDOS (tm) 
NEWDOS (tm) 
TRS-80 (tm) 
TRSDOS (tm) 
Z80 (tm) 



Percom Data Co. 

Micro Systems Software. 

Logical Systems Inc. 

Apparat, Inc. 

Radio Shack, a division of Tandy Corp 

Radio Shack, a division of Tandy Corp. 

Zllog, Inc. 
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MULTIDOS 

Copyright (c) 1981, 1982, 1984 by Cosmopolitan Electronics 
Corporation. 



SUPERBASIC 

Copyright (c) 1981, 1982, 1984 by Cosmopolitan Electronics 

Corporation. 



MULTIDOS MANUAL 

Copyright (c) 1984 by Cosmopolitan Electronics Oorpcratioa. 
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MULTIDOS and all Cosmopolitan Electronics Corporation products 
are distributed exclusively by AlphaBit Communications. Inc. 
Alphabit personnel will answer questions about Multidcs to the 
best of their ability. Requests for detailed technical 
Information will be passed on to the author of MULTIDOS, Vernon 
Hester, to be dealt with on an as-tlir/-~pcrmii:.3 basic*. Anv 
comments or requests for information should be directed to: 

AlphaBit Cocmuaications, Inc. 
13349 Michigan Ave. 
Dearborn, MI 40125 
(313) 581-2896 
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MAKING A BACKUP 

The first thing you should do with the MULTIDOS master diskette 
is make a backup. You will need a blank diskette to hold the . 
backup copy. Be sure you do not have a write protect tab on the 
backup diskette. 

LEAVE THE WRITE PROTECT TAB ON THE MULTIDOS MASTER DISKETTE. 

Turn on the computer and insert the MULTIDOS diskette into drive 
0, then press the RESET button. 

You will see the MULTIDOS banner, and the date prompt. Enter the 
date and press <EHTER>. 

Type the word BACKUP, then press the <ENTER> key. You'll get a 
series of prompts. 

'WHICH DRIVE CONTAINS THE SOURCE DISKETTE?' 
Answer with 0. 

'WHICH DRIVE FOR THE DESTINATION DISKETTE?' 

Answer with 1 if two drives are available (each having the same 

number of tracks) , otherwise answer with 0. 

'PRESS "ENTER" WHEN THE SOURCE DISKETTE IS IN DRIVE 0'. 
Press <^ENTER>. 

At this point MULTIDOS will examine the source diskette for track 

count and density. The track count will be 35 for the MODEL I, 

and 40 for the MODEL III, MAX-80, or MODEL A. The density will 

be the one ordered for the MODEL £, and double for the MODEL III, 
MAX-80, or MODEL 4. 

Answer 'TRACK COUNT FOR THE DESTINATION DISKETTE ( 35 to 96 )?' 
with <ENTER> 

MULTIDOS will format the blank diskette, then duplicate the 
contents of the MULTIDOS master diskette. 

If only one drive is available, BACKU1 will tall you vhen to 
insert the blank (destination) diskette, and when to re-ini-irt 
the MULTIDOS master (source) diskette. During a one drive 
BACKUP, you will have to change diskettes frcn time to time. 

When BACKUP has completely duplicated the MULTTTOS master 

diskette, 

'COMPLETED 

will be displayed. Press < ENTER >. 

Place the MULTIDOS master diskette in a safe place, and create 
all future backups from the copy just produced. 
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MULTIDOS 



MULTIDOS is a TR.S-80 disk operating system developed to provide a means of 

communicating with the other disk operating systems currently on the 

market. In addition, MULTIDOS contains major enhancements which make the 
program easy to use. 

The word "TYPE" in he chart below classifies all known operating systems, 
and is determined by four factors. 

1) The type of address marks used to identify the directory. "U" indicates 
USER DEFINED. "D" indicates DELETED. 

2) The use of psuedo-logical tracks. "P" indicated psuedo-logical tracks. 

T indicates true logical tracks. 

3) Track zero formatted in a different density than the balance of the 
diskette. "Z" indicates the same density. "X" indicates a different 
density. 

4) The lowest sector number assigned to each track. "0" = Numbered zero. 

1 = Numbered one. 
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SINGLE 
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NOTE 1 


NOTE 
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NOTE 1 


NOTE 
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NOTE 
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NOTE 1 


NOTE 
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NOTE 
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SINGLE 
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NOTE 1 


NOTE 
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NOTE 
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NOTE 
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NOTE 
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SINGLE 
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NOTE 
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SINGLE 
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SINGLE 
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OK 


OK 


OK 




OK 
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DBLDOS 


DOUBLE 


DPXO 


OK 


OK 


OK 




OK 
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VTOS 


DOUBLE 


DPXO 


OK 


OK 


OK 




OK 
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NEW DOS 80-1 


DOUBLE 


DPXO 


OK 


OK 


OK 




OK 
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NEW DOS SO- 2 


DOUBLE 


DPXO 


OK 


OK 


OK 




OK 
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OK 
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OK 
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LDOS 
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OK 


OK 


OK 




OK 
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TRSDOS 


DOUBLE 
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NO 


NO 


NO 




NO 
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TRSDOS 
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VFU 


NO 


VFU 




NO 
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DOSPLUS 


DOUBLE 
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OK 


OK 


OK 




ok 




III 


LDOS 


DOUBLE 


DTZO 


OK 


OK 


OK 




OK 
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NEW DOS 80- 2 


DOUBLE 


DPZO 


OK 


OK 


OK 




OK 
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TRSDOS 
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DfZO 


OK 


OK 


OK 




OK 
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DOSPLUS 


DOUBLE 


DTZO 


OK 


OK 


OK 




OK 
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OK 


OK 




OK 
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LIX3S 


DOUBLE 
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OK 


OK 


OK 




OK 
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MULTIDOS. 


DOUBLE 


DTZO 


OK 


OK 


OK 




OK 
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VFU = VFU/CMD can copy a file r.tOM these types. 

NOTE 1: These types vill have their address marks changed. 

NOTE 2 = Requires COII VERT/CM D to alter the directory address mar 
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MULTIDOS MANUAL NOTATION 

The notation in the list below is used throughout the MULTIDOS manual. 

Symbol Meaning 



<ENTER> 
<BREAK> 
<SPACE> 
<COMMA > 
<LF> 

Filespec 
Drivespec 
[ J 

{ > 

A space 

Punctuation 

Single quote 



Press the "ENTER''' ke.'. 

Press the "BREAK" key. 

Press the "SPACE-BAR". 

Press the "," key. 

A linefeed character, the down-arrow. 

A valid MULTIDOS file. 

A particular logical disk drive number (0 to 7) 

Brackets enclose optional parameters. 

The "[" and "]" are not keyed in. 

Braces enclose manual remarks. 

At least one mandatory space. 

Must be entered as shown. 

Encloses MULTIDOS responses shown on the video monitor. 

Ellipses represent the repetition of an optional parameter 



COMMANDS 

Whenever the command prompt, 
MULTIDOS 

Is displayed, the user may enter a command followed by <ENTER>. 

EXAMFLE: 

FREE<ENTER> 

The above command instructs MULTIDOS to display the amount of free granules 
remaining on all drives . 

The maximum length of a command is 63 characters for the MOLEL I and 
MODEL III, and 79 characters for the MAX-80 and MODEL 4. All commands must 
terminate with <ENTER>. 

Commands may be entered in any combination of upper and lower case. The 
command interpreter performs a case conversion to all upper case unless a 
special bit is set in a control byte, (SMO), described in the technical 
section. 
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MULTIDOS 

When specifying a disk file the term "filespec'* is used in the MULTIDOS 
manual. "A filespec with all the options looks like this: 

FILENAME [ /EXT ] [ . PASSWORD ] [ : d ] 

FILENAME is the name of the disk file. Valid filenames consist of at 
least one and not r.ore than eight characters. The first character must 
be alphabetic (A-Z), and the remaining characters can be alphabetic or 
numeric (A-Z, and/or 0-9). 



j /EXT is an optional extension to the FILENAME and consists of the 

I slash character (/) and at least one, but not more than three 

characters. The first of these characters must be alphabetic. The 
-» remaining characters can be alphabetic or numeric. All file 

"j extensions, except "/CMD", must be entered for proper identification 

• of the file. More on this later. 

I .PASSWORD is an optional password preceded by a period consisting of 

one to eight characters. The first character must be alphabetic and 
the remaining can be alphabetic or numeric. 

| :d is an optional logical drivespec number, to 7, preceded by a 

j colon. 

^x NOTE: A filespec does NOT have any spaces on it. Spaces are treated as 

1 separators by MULTIDOS. Lf a filespec is spaced, only the contents 

| preceding the space will be interpreted as the filespec. 

The PASSWORD is NOT part of a filespec's uniqueness. The following are 
I interpreted as the same filespec: 

WONDER. BOY WONDER. WOMAN WONDER. FULL 
| however, the following are unique filespecs: 

WONDER : 1 WONDER : 2 WONDER : 3 

I because the drivespecs are different. 

The following are filename extensions generally employed: 

I/ASC A basic program stored in ASCII form. 

/ASM An assembly language source file. 

/BAS A basic program stored in compressed format. 

• /CIM A file created by the DUMP library command. 

I /CMD A machine language file executable directly from DCS. 

* /REL A relocatable object file. 
/SYS An operating system's overlay. 

i /TXT An ASCII text file. (Typically sequential files) 
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MULTIDOS 



MULTIDOS will insert the extension /CMD, if a filespec is entered without 
an extension. 

EXAMPLE: 



1 
1 



BACKUP<ENTER> 

MULTIDOS will add the extension "/CMD" to BACKUP, then load and execute the 
file BACKUP/CMD. 

To execute a file without an extension, append just the "/" and MULTIDOS 
will load and execute the file without adding the default extension "/CMD". 

EXAMPLE: 

CREATE /<ENTER> 

MULTIDOS will load and execute the file CREATE. 

If a drivespec is not assigned, MULTIDOS will search all active drives, in 
ascending logical order, starting with logical drive for the filespec 
entered. If a filespec Is initialized (new file created) without a 
drivespec, MULTIDOS will search for the first active drive with the disk 
write enabled to Initialize the file. 

EXAMPLE: 

PR0G:2<ENTER> 
MULTIDOS will look for the program PROC/CMD on logical drive two. 
EXAMPLE: 

PRCG/<ENTER> 

MULTIDOS will search the drives, in logical ascending order, then load and 

execute the program PROG on the first drive PROG exists on. If FROG is on 

logical drives 3 and 4, the version on logical drive 3 will be loaded and 
executed. 



EXAMPLE: 

PROG/RAM<ENTER> 

MULTIDOS will search the drives, in logical ascending order, then load and 
execute die program PROG/RAM on the first drive PROG/RAM exists on. If 
PROG/ RAM is on logical drives 3 and 4, the version on drive 3 will be 
loaded and executed. If the user wants to load and execute the file 
PROG /RAM on logical drive 4, then "PROG/RAM: 4<ENTER>" must be entered on 
the command line. 
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MULTIDOS 



More on COMMANDS 

Multiple DOS commands wilL be executed if they are separated by commas 
immediately behind- the commands. 

EXAMPLE: 

DIR 1, BASIC<ENTER> 

1. Displays the directory on logical drive one. 

2. Loads and executes SUPERBASIC. 

The library command HELP (MAX-80, and MODEL 4), or the file HELP/CMD 
(MODEL I, and MODEL III) overrides any inquiry when a comma follows the 
command help is requesting. 

EXAMPLE: 

HELP FORMS, DIR<ENTER> 

This will be interpreted as if only HELP<ENTER> was entered. 



^ 



MULTIDOS will repeat the last DOS command if <ENTER> is the first response 
to the command prompt. 

EXAMPLE: 

DIR :1<ENTER> 

After the command prompt is displayed, pressing <ENTER> as the first 
keystroke will again display the directory of the disk in logical drive 1. 
The diskettes can be changed between the <ENTER>'s. 
To erase the last DOS command press the <3REAK> key. 

This feature can be useful if a lengthy command is used to write to a write 
protected diskette. Simply write enable the diskette and press <ENTER> to 
repeat the aborted command. 

The use of the RESET library command will disable any multiple DOS 
command(s) following RESET and erase the last DOS command. 

EXAMPLE : 

RESET, DIR 1<ENTER> 

When this command is executed, RESET will be performed; however, "DIR I" 
will be ignored and the command "RESET, DIR 1" will be erased. 

MULTIDOS provides an easy method to obtain a directory by keying in the 
numbers to 7 as the c irst character in the conmand promt. (The i<?<DEL I. 
and MODEL III do not allow backspacing. - Press <BREAK> to restart.) 



^ 
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MULTIDOS 

SPECIAL UNIVERSAL COMMANDS 

I - minidos 

This feature will permit the user to Interrupt most programs while 

executing and execute several selected commands then return to the main 

program without any changes in le main program's state during this 

interruption. Minidos will be activated if the following conditions are 
met: 

1. Interrupt service is active. 

2. Simultaneous depression of the ":" and ";" keys. - MODEL I/MODEL III 
Simultaneous depression of the "D", "F", and "G" keys. - MAX-80/M0DEL 4. 

To exit minidos: 

1. Press <BREAK> or 

2. Key in "!" As the first input character. 

However, upon exit an extraneous character might be present. 

Minidos commands require only one letter and do not require a space 
terminator. However, spaces may be keyed in after the command letter. 

EXAMPLE : 

DKENTER> is interpreted the same as D 1<ENTER> 

The commands available are: 

"C" , COPY - Duplicate a file from one mounted disk to another mounted disk. 

"D", DIR - Display the directory of the specified drivespec. 

"K", KILL - Remove the specif led. filespec. 

"L", LIST - List the specified filespec. 

"M" , - DEBUG. ***** MUST NOT BE INVOKED UNTIL minidos IS EXITED. 

"P", - Send specified decimal character to the printer. (MODEL I/III) 

"V", - Flip the video format between 64X16 and S0X24. (MAX-80/M0DEL 4) 
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MULTIDOS 

1.1 - minidos COPY - Copies Eites, <C>. 

C fiLeonel :<1J [to] f i Le t»o[ :d ]<ENTER> 

1.2 - minidos DIRECTORY - Display disk directory, <D>. 

Dd, Did, DSd, l? d, DI:d, or DS:d<ENTER> 

D = to 7 for the logical drive number. 

If "d" is not entered, then zero is used. 
I = display files with an Invisible attribute. 
S = display files with an invisible or system attribute. 

1.3 - minidos KILL - Delete file, <K>. 

K filespec<ENTER> 

1.4 - minidos LIST - List a file to the display, <L>. 

L filespec<ENTER> 

The listing will be suspended if the <SPACE-BAR> is held down, or 
terminated if <BREAK> is pressed. 

1.5 - Activate DEBUG, <M>. 

M<ENTER> 

minidos does not flag the user anything has happened. However, DEBUG should 
not be invoked until an exit from minidos io made. Minidos and DEBUG have 
totally different exit routes. These different exit routes correctly return 
to the command in process prior to minidos or DEBUG being invoked. If DEGUG 
is invoked during minidos, an exit from DEBUG vill attempt to use minidos' 
exit route and will hang the system. 

1.6 - minidos PRINT - Send a decimal byte to the printex DCB, <?>. 

Pnn<ENTER> 

nn must be in the range of to 99. The main purpose of this cr.mmand is 
send control bytes, to 31, to the printer without leaving the main 
program in progress. (This command is not on the L'AX-80 or MODEL 4.) 

1.7 - Flip video format, <V>. (MAX-BO/MODEL 4) 

V<ENTER> 

This command will clear the display then flit? the video between the 64X16 
format and the 80X24 format. If the current video format is 80X24, then 
"VXENTER" will change the display to 64X16. If the current disniay format 
is 64X16, then "V<ENTER" will change th- displa" to S0X24\ 
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MULTIDOS 

II - <JKL> Dump the screen display to the printer. 

<JKL> = The simultaneous depression of the "J", "K", and "L" keys. 

This function sends the current contents of the display to the device 
defined in the printer DCB. Graphic blocks are converted to the 
character. If graphic blocks are nc to be converted to the "." character 
then the <HJK> function, described below, should be used. 

III - <HJK> Dump the screen display to the printer, including graphics. 

<HJK> = The simultaneous depression of the "H", "J", and "K" keys. 

This command is similar to the <JKL> command, except graphics blocks will 
be sent to the printer Instead of being converted to " . " characters. 
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00 


NUL 


32 


20 


SPACE 


64 


40 


@ 


1 


01 


SOH 


33 


21 


i 


65 


41 


A 


2 


02 


STX 


34 


22 


•• 


66 


42 


B 


3 


03 


ETX 


35 


23 


# 


67 


43 


C 


4 


04 


EOT 


36 


24 


$ 


68 


44 


D 


5 


05 


ENQ 


37 


25 


% 


69 


45 


£ 


6 


06 


ACK 


38 


26 


& 


70 


46 


F 


7 


07 


BEL 


39 


27 


" 


71 


47 


G 


8 


08 


BS 


40 


28 


( 


72 


48 


H 


9 


09 


HT 


41 


29 


) 


73 


49 


I 


10 


0A 


LF 


42 


2A 


* 


74 


4A 


J 


11 


0B 


VT 


43 


2B 


+ 


75 


4B 


K 


12 


OC 


FF 


44 


2C 


i 


76 


4C 


L 


13 


0D 


CR 


45 


2D 




77 


4D 


M 


14 


01 


SO 


46 


2E 


. 


78 


4E 


N 


15 


0s 


SI 


47 


2F 


/ 


79 


4F 





16 


10 


DLE 


48 


30 





80 


50 


P 


17 


11 


DC1 


49 


31 


1 


81 


51 


Q 


13 


12 


DC 2 


50 


32 


2 


82 


52 


R 


19 


13 


DC 3 


51 


33 


3 


83 


53 


S 


20 


14 


DC4 


52 


34 


4 


84 


54 


T 


21 


15 


NAK 


53 


35 


5 


85 


55 


U 


22 


16 


SYN 


54 


36 


6 


86 


56 


V 


23 


17 


ET3 


55 


37 " 


7 


87 


57 


w 


24 


i °. 


CAN 


56 


38 


8 


88 


58 


■u 


25 


19 


EM 


57 


39 


9 


89 


59 


Y 


26 


1A 


SUB 


58 


3A 


: 


90 


5A 


Z 


27 


IB 


ESC 


59 


3B 


• 


91 


5B 


[ 


28 


1C 


FS 


60 


3C 


< 


92 


5C 


\ 


29 


lb 


GS 


61 


3D 


=5 


93 


5D 


1 


30 


IE 


RS 


62 


3E 


> 


94 


5E 




31 


IF 


US 


63 


3F 


? 


95 


5F 
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MULTIDOS SYSTEM DISKETTES 

MULTIDOS requires specific DOS overlay files (/DOL) present on a MULTIDOS 
disk, mounted in logical drive 0, for proper operation. 

A MULTIDOS minimum system disk contains the following six files: 

SYSRES/SYS - This is the executive program loaded during initialization. 
SYSRES/SYS contains the necessary routines to interface with 
the hardware being used. SYSRES/SYS also contains system 
scratchpad, vectors to internal routines, drive control 
table (DCT), floppy disk I/O routines, program loader, and 
file positioning. 

DIR/SYS - This file contains all of the data on every file on the 
disk. 

Command/DOL - The command interpreter. Command/DOL also contains the code 
for the library commands BLINK, BOOT, CLEAR, CLOCK, CLS, 
DEAD (MODEL I/III), LIB, LOAD, SCREEN, and VERIFY. The 
MAX-80/Model A version also contain the code for V64 and 
V80. 

Open/DOL - This file contains the code to OPEN and INITialize a file. 



Allocate/DOL - This file contains the code to allocate granules and file 
| positioning to a record in the fifth or greater segment. 



Close/DOL - This file contains the code to CLOSE and KILL files. 



Other MULTIDOS files are required to execute certain commands and perform 
certain functions. The other MULTIDOS system files are: 

Error/DOL - Disk access related error library. 

Debug/DOL - DEBUG file. 

Minidos/DOL - Executor of minldos. Minidos/DOL also contains the code to 
execute the system command CAT. This system command is not 
the same as the utility CAT/CMD. 

Libraryl/EXT - Executor for the library commands APPEND, AUTO, BUILD, DATE, 
DEVICE, DIR, DO. DUMP, FREE, KILL, LINK, LIST, PRINT, ROUTE, 
TIME, and TOPMEK. 



Librarv2/EXT - Executor for the library commands: ATTRIB, CLRDSX, CONFIG, 
DDAM (MODEL I), FORMS, KEYBRD, PATCH, PROT, RENAME, RESTCR, 
j SETCOM (MODEL III), and SKIP. 

Help/EXT - Executor of the library command HELP. (MAX-80/M0DLL 4) 
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MULTIDOS 

MULTIDOS requires a MULTIDOS system disk to be in logical drive to load 

and execute a /CMD* f ile from a MULTIDOS dink, a data disk, or an "alien" 

system diskette. MULTIDOS will not execute programs specifically written 
for an "alien" DOS. i.e. PROFILE LIT.+ . 

Proper operation of certain MULTIDOS utilities do not require a MULTIDOS 
system disk in logical drive 0. F ecific system restraints are covered in 
the description for the particular utility in the SYSTEM UTILITIES section 
of the MULTIDOS manual. MULTIDOS requires that a system disk be in logical 
drive When any MULTIDOS utility is loaded and executed. 

To remove system files, use the utility VFU/CMD with the "%" parameter. 

EXAMPLE: 

VFU %<ENTER> 

The "%" permits VFU/CMD to access the "/DOL" and "/SYS" files. 

DO NOT USE VFU/CMD TO COPY A DIR/SYS FROM ONE DISK TO ANOTHER!! 

The removable system files are: 

Error/DOL - Disk access related error library. 

Debug/DOL - DEBUG file. 

Minidos/DOL - Executor of rainidos. Minidos/DOL also contains the code to 
execute the system command CAT. This system command is not 
the same as the utility CAT/CMD. 

Libraryl/EXT - Executor for the library commands APPEND, AUTO, BUILD, DATE, 
DEVICE, DIR, DO, DUMP, FREE, KILL, LINK, LIST, PRINT, ROUTE, 
TIME, and TOPMEM. 

Librarv2/EXT - Executor for the library commands: ATTRIB, CLRDSK, CONFIG, 
DDAM (MODEL I), FORMS, KEYBKD, PATCH, PROT, RENAME, RESTOR, 
SETCOM (MODEL III), and SKIP. 

Help/EXT - Executor of the library command HELP. (MAX-80/MODEL 4) 
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LIBRARY COMMANDS 

MULTTDOS library commands are usually entered after the 
MULTIDOS prompt has been received. However, the library 
, commands can be executed from SUPERBASIC, or an assembly 
language routine. 

A mandatory space is required after all library commands if there are 
additional parameters or arguments. 



EXAMPLE: 

DATE<ENTER> {No space required. No arguments given} 
( This displays the current RAM date in the format mra/dd/yy. 

^ DATE ll/08/84<ENTER> {At least one space after DATE} 

1 This establishes November 8, 1984 as the current RAM date. 



Multiple library commands will be executed, in sequence, if a comma follows 
the last character of a given command. 

EXAMPLE: 

DIR (A),DIR 2(A), DIR 1(A)<ENTER> 

This multiple command x^ill display the <A>llocation directory for logical 
drives 0, 2, and 1, in that order. 

RENAME NEW/CMD:2 TO OLD/CMD, DIR 2<ENTER> 

This multiple command will rename "NEW/CMD" on the disk in logical drive 2 
to "OLD/CMD", then display the directory of the disk in 
logical drive 2. 

Whenever the terra "switch" is part of a MULTIDOS library command line, 
"switch" represents an ON/YES or OFF/NO conditiou. If the 
"switch" is omitted, then ON/YES will be used. 

MULTIDOS accepts the following responses: 



(Y) 


= yes, on 


(N) 


= no, off 


(YES) 


= yes, on 


(NO) 


= no, off 


(ON) 


= yes, on 


(OFF) 


= no, off 



Please note the required "(" and ")" surrounding the switch parameter. 
EXAMPLE: 

(1) CLOCK (N)<ENTER> 

(2) CLOCK (Y)<ENTER> 

(3) CL0CK<ENTER> 

Example (1) will suppress the clock display, and examples (2) and (3) will 
display the clock. 
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APPEND Append a file to the end of another file. 
APPEND fdlespecl [to] f ilespec2<ENTER> 

APPEND will add filespecl to the end of fLlespec2, increasing the length of r 

filespec2 by the length of filespecl, leaving filespecl • 
unaffected. The disk with filespec2 must not be write 
protected and have sufficient space to lengthen filespec2 by 

the length of filespecl. APPEND requires both filespecs to i 

have the same logical record length. * 

To append BASIC programs, both files must be stored in ASCII, and the 

highest line number in filespec2 must be lower than the | 

lowest line number in filespecl. * 

EXAMPLE: 

J 
10 REM CLASS1/TXT * 

20 DATA "ENGLISH", "FRENCH" , "GERMAN" , "GREEK"," PIG LATIN" 

200 REM CLASS2/TXT : * 

250 DATA "SOCIAL SCIENCE" , "HISTORY" , "CHEMISTRY" , "ALGEBRA" 

J 

APPEND CLASS2/TXT to CLASS1/TXT<ENTKR> 

The file CLASS1/TXT will have the contents of file CLASS2/TXT added to the 

end of the original contents of CLASS L/TXT, and the file 

CLASS2/TXT will be unchanged. Here Ls the results of the 
APPEND. 

CLASS 1/TXT after CLASS2/TXT is appended: i 

10 REM CLASS1/TXT 

20 DATA "ENGLISH V , FRENCHV , GERMAN", "GREEK", "PIG LAT/N" * 

200 REM CLASS2/TXT * 

250 DATA "SOCIAL SCIENCE" , "HISTORY", CHEMISTRY" , ALGEBRA" 

CLASS2/TXT after it is appended to CLASS 1/TXT: '{ 

200 REM CLASS2/TXT 

250 DATA "SOCIAL SCIENCE" , "HISTORY", CHEMISTRY" , ALGEBRA" 

\\ 

APPEND cannot append files from cwo diskettes to be mounted in the same 
logical drive. All disks must be mounted to append files. 

APPEND NEXT/TXT: 2 BEFORE/TXr : 1<ENTER> 

The file NEXT/TXT on the disk in logical drive 2 will be. appended to the r 

file BEFORE/TXT on the disk in logical drive ] . • \ 
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LIBRARY COMMANDS 

ATTRIB Assign a fllespec's attributes. 

ATTRIB filespec (param[ ,pqraiiw . . ])<ENTER> 

This command sets file protection attributes. 

Param meaning: 

I The file is invisible to the normal directory command. 

V The file is visible to the normal directory command. 

A=pw pw = The new ACCESS password. 

U=pw pw = The new UPDATE password. 

P=level level = The protection level. (Detailed below) 

The protection level is entered as words. I.E. READ, EXEC, etc. 

Level ACCESS password privilege 

KILL TOTAL ACCESS (lowest level) 

RENAME RENAME, WRITE, READ, EXECUTE 

WRITE WRITE, READ, EXECUTE 

READ READ, EXECUTE 

EXEC • EXECUTE ONLY 

NONE LOCKED OUT (highest level) 

If a file has a protection level of WRITE, then the file can be accessed by 
any of the levels equal to or higher than WRITE, I.E. READ, EXECUTE, with 
the use of the access password. The file cannot be RENAMEd or KILLeJ 
without the update password. 

The access attribution does not require an update or protection level 
attribute. Files with access attribution require the ACCESS password for 
any access to the file. 

All files have an ACCESS and UPDATE password. The default password is 8 
spaces. With a password set to 8 spaces (blank), a password is not required 
to access the file. The library command DIR will display a "P" after the 
filename, if a protection level is set and the file has a non-blank UPDATE 
password. 

EXAMPLE: 

ATTRIB FILEA/EAS (A=,U=SAM,P«READ)<ENTER> 

FILEA/BAS can be executed, loaded, and read without passwords. To KILL, 
RENAME, or WRITE to the file, the UPDATE password "SAM" must be used. 

ATTRIB FILEB/BAS (V)<ENTER> 

FILEB/BAS is visible and will be displayed when the library command DIR is 
executed. 
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LIBRARY COMMANDS 

Automatic command upon power -up/ re -boot. 



AUTO [ (!][*#] DOSCMD ] [ <LF>DOSCMD ] < ?.NTER> 

DOSCMD is any valid MULTIDOS library command or a filespec for an 
executable command file. The AUTO command will store ^up to 
31 characters, after the mandatory space following "AUTO", 
on the GAT sector of the directory. If more than 31 
characters are entered, no error message will be given; 
however, only the first 31 characters are stored. Since the 
"AUTO" command writes to the directory, the diskette must 
not be write protected when the "AUTO" command is set up or 
removed. 



I 



EXAMPLE: 

AUTO DIR<ENTER> 

On future power -ups the library command DIR will be executed after 'DIR' 
appears on the display. 

AUTO provides for automatic operation of one or more MULTIDOS commands or 
executable command files upon power -up/ re -boot. Multiple 
AUTO commands require a <LF> between each command or 
filespec to be executed upon power -up/ re -boot. 

EXAMPLE: 

AUTO DIR<LF> 

FREE<LF> 

BASIC<ENTER> 

On subsequent power-up/re -boots , MULTCDOS will display 'DIR', execute the 
library command DIR, display 'FREE', execute the library 
command FREE, display 'BASIC, then load and execute the 
file BASIC/CMD. . 

MULTIDOS will accept a multiple command for an AUTO command. The multiple 
command will be displayed once. 

EXAMPLE: 

AUTO DIR, FREE, BASIC<ENTER> 

On subsequent power -up/ re -boo ts , ' MULTIDOS will display 'DIR, FREE, BASIC , 
execute the library command DIR, execute the library command 
FREE, then load and execute the file BASIC/CMD. 

An AUTO command will be removed if only <ENTER> follows AUTO. 

EXAMPLE: 

AUTO<ENTER> 

This will remove an AUTO command, provided the diskette in logical drive 
zero is write enabled. 



I 
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LIBRARY COMMANDS 

Once an AUTO command is <et up, it is often desirable to suppress the AUTO 
eo.imand during subsequent power-up/re -boots . To suppress an 
AUTO comma ;vi 'tol.l down the <ENTI£R> key during the 
power -up./ re -roo {. sequence . 

On the other hand, the programmer may want an AUTO command to execute 
without Lh«» ability of the user to suppress the AUTO 
command. To inhibit the suppression Of an AUTO command, key 
in an "!" (evcl ima ': ion mark) as the first character after 
the mand'i tory space following "AUTO". 

EXAMPLE: 

AUTO ! 3A3TC<KNVl':!r> 

On subsequent power-ups, the file BASiC/CMD will load and execute after 
'BASIC is displayed, whether the <EHTER> key is held down 
or not. 

The programmer can make an AUTO command invisible if a "if" (pound sign) is 
placed in front of the first command. 

EXAMPLE: 

AUTO '/BAcU'.XEN'TElO 



On subsequent power-ups, the file BASIC/CMD will load and execute, but 
| "BASIC" will not displayed on the screen. 

When setting up AUTO commands, the programmer may wish to observe the 

results of the AUTO command and change it as necessary, 

I without re -boo ting the computer. To execute an AUTO command, 

without re -boo ting, key in: 



AUTO %<ENTER> 
A multiple AUTO command will be converted to a multiple command AUTO. 
To query an AUTO command without re -boo ting the computer, key in: 

AUTO ?<ENTER> 

RULES FOR AUTO COMMANDS: 

1. If BASIC is part of an AUTO command, BASIC must be the LAST command. 

2. If a "DO file" is part of an AUTO command, then the "DO file" must be 
the LAST command . 

EXAMPLE: 

AUTO DO STARTUP, DIR 1<ENTER> 

This AUTO command is incorrect. The "DO file" is not the last command. The 
command "DIR 1" will not execute. The programmer should include "DIR 1" In 
the "DO" file STARTUP, or rearrange the AUTO command to: 

AUTO DIR 1,D0 STARTUP<ENTER> 
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LIBRARY COMMANDS 
BLINK Disable or enable the blinking cursor. 
BLINK [ switch ]<ENTER> 

This command will enable the blinking cursor when "switch" is ON/YES or 
disable the blinking cursor when "switch" is OT\F/NO. 



EXAMPLE: 



BLINK<ENTER> {Enables Mie blinking cursor} 

BLINK (OFF)<ENTER> (Disables the blinking cursor} 



BOOT Reset the computer. 

BOOT<ENTER> 

This command will cause a software reset. BOOT requires no arguments or 
parameters. 



BUILD Create a "DO" file. 



BUILD filespec [( A) J<ENT!2R> 



BUILD creates a disk file to store a series of keystrokes for execution by 
the DO command. The data in the disk file is interpreted by the DO command 
as keyboard entries. BUILD will overwrite the fiLespec unless the "A" 
option is specified. If the "A" option is specified, then BUILD will add 
the input to the end of filespec. 



EXAMPLE: 



BUILD STARTUP<ENTER> 
BUILD STARTUP (A)<ENTER> 



{Build input will overwrite STARTUP.} 
{Build input will ADD to STARTUP.} 



To BUILD a "DO" file, follow these steps: 

1. Key in "BUILD filespec". 

2. When the prompt 'Build input' appears, key in (up to 255 characters per 
build line) the keystrokes desired for "DO" execution. The <ENTER> key 
will terminate a build line and store an <ENTER> in the file. 

3. Continue step 2 to store all of the desired keystrokes. 

4. When the next 'Build input' appears press <BREAK> to close the file. 

Although BUILD will accept 255 characters per build line, the command 
buffer can only hold 63 characters (MODEL I/MODEL III), or 79 characters 
(MAX-80/M0DEL 4). The 255 byte line was incorporated into BUILD to accept 
long commands (see the "%" explanation on the next page.) 
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LIBRARY COMMANDS 

BUILD has three special chnr.-iot^rs "if" t "$", and "%", to pause a "DO" file 
or suppress video output. r.n» thr.-«,» special "BUILD" characters are only 
recognized if- they an the fir^r *'.*. inc t-?r in a "SUILD" line. 

The "//" character Is u«*a to p .i.i-*.» .^cation of a "DO" file. The "//" 
character can be the only ivip-it *:>r i hoi Id line or the "//" character can 
precede a message to display bef *iv the pause occurs. 

EXAMPLE: 

Build innut 
XENTER> 

Pauses "DO" and waits until a "Slii>"T" key is pressed. 

//INSERT DISK NUMBER 77<ENTER> 

Pauses "DO", after displaying the message 'INSERT DESK NUMBER 77', and 
waits until a "SHIFT" key is pressed. 

The "$" character will suppress video output and continue "DO" execution if 
the "$" character is the only input for a build line. If text follows the 
"$" character, then the text is printed, the video is suppressed, and the 
"DO" file pauses. 

EXAMPLE: 

Build input 
$<ENTER> 

Suppresses video output and continues "DO" file, 

$This is the beginning of darkness !<ENTER> 

Will display the message. 'This is the beginning of darkness!', Suppress 
video output, then wait for a <SHIFT> to continue. 

The video display is turned on whenever a "DO" file is completed. Since 
MULTIDOS can nest "DO" files, video output is enabled when ANY "DO" file 
completes. 

The "%" character is BUILD's comment character. The "%" character must have 
additional text following or an error will occur during "DO" execution. The 
"%" character is required for each comment line terminated with <ENTER>. 

EXAMPLE: 

%We the people of the United States, in Order to form a more<LF> 
Perfect Union, establish Justice, insure domestic Tranquility ,<LF> 
Provide for the common defence, promote the general Welfare ,<ENTER> 
%And secure the Blessings of Liberty to ourselves and our<LF> 
Posterity, do ordain and establish this Constitution for the<LF> 
United States of America. <ENTER> 
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LIBRARY COMMANDS 
Example of BUILDlng a file for DO execution : 



When DO BLAST is entered from tho co.nmand prompt: 



%zzzzz display zzzzz and continue. 

To display a message and continue: 

%Message<ENTER> 
To display a message and pause: 

//Message<ENTER> 
To display a message, suppress video output, and continue: 

%Message<ENTER> 

$<ENTER> 
To display a message, suppress video output and pause: 

$Message<ENTER> 
To pause: 

//<ENTER> 
To suppress video output and pause: 

$<ENTER> 

#<ENTER> 
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BUILD BLAST<ENTER> 

CLS<ENTER> 

^LOADING BASIC<ENTElO . 

BASIC 61440<ENTER> { 

CLS<ENTER> 

7.GET READY FOR A BLAST KENTEiO 

RUN M BLAST/BAS M <ENTER> 

<BREAK> 



The screen will clear. [CLS] 

The message 'LOADING BASIC will appear. [%LOADING BASIC] 

BASIC will load with memory set to 61440. [BASIC 61440 J 

The screen will clear. [CLS] | 

The message 'GET READY FOR A BLAST !' Will appear. [%GET. READY FOR A BLAST] ■ 

The program "BLAST/BAS" will load and execute. [RUN"BLAST/BAS" ] 

Special BUILD characters are summarized in the following table: I 

BUILD Character Action description. 

j? pause and waits Cor <SI1IFT> { 

press prior to continuing. 

//zzzzz pause after displaying zzzzz and v 

wait for <SHIFT> press prior ' } 

to continuing. 

$ suppress video output. ^ 

$zzzzz suppress video output after displaying 

message zzzzz and wait for a , 

<SHIFT> press to continue. \ 



J 
J 
I 
J 



"1 



1 



1 
I 
I 



I 



I 
I 
I 
J 
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LIBRARY COMMANDS 

CLEAR Zero Random Access Memory (RAM). 

CLEAR<ENTER> 

CLEAR zeroes RAM from 5200H to TOPMEM. If the contents of TOPMEM is FDFFH, 
CLEAR will set all bytes from 520011 through FDFFH to 00. 

CLOCK Enable or disable the real time clock display. 
CLOCK [ switch ]<ENTER> 

The ON switch will cause the real time clock to be displayed at the top 
right of the video display. The OFF switch will suppress the display of the 
real time clock. To set the clock, use the library command TIME. 



EXAMPLE: 



CLOCK (0N)<ENTER {The real-time clock Is displayed} 
CLOCK (0FF)<ENTER> {The real-time clock is not displayed} 



CLRDSK Zero a disk's unused granules. 

CLRDSK[ [:]d]<ENTER> 

CLRDSK will erase unassigned granules on the disk in the specified logical 
drive by placing a continuous pattern of E5E5 bytes en each unassigned 
granule for single density media, and a 6DB6 byte pattern on each 
unassigned granule for double density media. This is the same pattern 
placed on the media by FORMAT/CMD, and the format function of BACKUP/CMD. 

EXAMPLE: 

CLRDSK :3<ENTER> {erase all unassigned granules on logical drive 3} 

CLS Clear the screen. 

CLS<ENTER> 

OLS clears the screen and sets the cursor to the upper left hand corner, 
CLS can be used in conjunction with other commands or programs to erase the 
previous screen data, and present only the new data to the user. 

EXAMPLE: 

CLS, FREE<ENTER> 
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CONFIG Default power -up/ re -boor. drive attributes. j 

CONFIG[ [[:]d] (P=p[,w][,N][,SI=k][,V=v][,ST=sj[,m][,X])]<ENTER> 

d « logical drive number, to 7. \ 

p = physical drive number. (Floppies can only be physical drive 0-3) 

w = write protect condition, WE = write enable, or WP = write protect 

N = nil logical drive. (Software remove the logical drive number) 

k = number of sides, i or 2. I 

v = volume, 1 or 2. 

s = stepping rate, 6, 10, 12, or 30. 

m = media type, 5=5 1/4" floppy, 8 = 3" floppy, or H = hard disk. 

X = write current RAM configuration to logical drive zero. I 

CONFIG<ENTER> displays current RAM configuration, including the density of 

the media, the status of SKIP, and MEMDISK assignment. j 

CONFIG establishes, for the system, the hardware characteristics 1) 
size/type of media - 5 1/4" floppy, 8" floppy, or hard disk; 2) number of 
sides L or 2; 3) volume 1 or 2; and 4) track to track access speed. ^ 

EXAMPLE: 

CONFIG 1(ST=6)<ENTER> {set logical drive I's stepping rate to 6ms} 

The CONFIG information is stored in the Drive Control Table (DCT) located 

in RAM from 4500H to 457FH. When a CONFIG parameter is changed, only the - \ 

DCT is RAM is modified. If the system is re -boo ted, the power -up 

configuration will be loaded into RAM. The X parameter is required to write 

out the DCT to logical drive 0. If a logical drive has been assigned to 

MEMDISK, then CONFIG (X) is ignored. \ 

CONFIG detail: 

d - logical drive. This is the drivespec recognized when a drive number is t 

part of a filespec, or the target disk in a library command. 

EXAMPLE: J 

PROG: 3 {logical drive 3} 

VALUE/BAS:1 {logical drive 1} 

DIR :2 {logical drive 2} ; 

BACKUP :1 to :2 {logical drive 1 to logical drive 2} J 

If access is made to a file without a drivespec, MULTIDOS will search for ; 

the file in ascending LOGICAL drive order. j 

EXAMPLE: 

I 
ZAP<ENTER> i 

The file ZAP/CMD is searched from logical drive to logical drive 7. If 
the file exists on logical drive 2, and logical drive 4, the version on 
logical drive 2 is loaded and executed. 
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LIBRARY COMMANDS 

p = physical drive. The physical drive is the actual drive accessed as 
directed by the DCT. The roaster MULTIDOS diskette assigns logical drive 
to 3 to physical drive to 3 respectively. 

EXAMPLE: 



C, 5" Floppy, double density, 
one volume, step rate = 06 mS. 

1, 5" Floppy, double density, 
one volume, step rate = 06 mS. 

2, 5" Floppy, double density, 
one volume, step rate = 06 mS. 

3, 5" Floppy, double density, 
one volume, step rate = 06 mS. 



C0NFIG<ENTER> 
:0, Physical = 

one sided, 
:1, Physical = 

one sided, 
:2, Physical = 

one sided, 
:3, Physical = 

one sided, 
:4, Nil 
:5, Nil 
:6, Nil 
:7, Ni. 1 

However, the user may need to change the physical drive to be accessed as 
the system drive - logical drive 0. Logical reassignment requires two 
CONFIG commands to complete. The first has two logical drives assigned to 
the same physical drive, and the second command would reassign one of the 
logical drives to another physical drive. For floppies, the programmer 
normally would not have a physical drive with more than one logical drive 
assigned to it at the same time. Whenever logical drive is to be 
reassigned, it is necessary to assign another logical drive to physical 
drive 0, prior to logical drive assignment to another physical drive. 

EXAMPLE: 

CONFIG :1 (P=0)<ENTER> 
CONFIG :0 (P=1)<ENTER> 

The first CONFIG command would have both logical drive 1 and assigned to 
physical drive 0. The second CONFIG command assigns logical drive to 
physical drive 1. The system diskette is now moved from physical drive to 
physical drive 1. After performing the above two CONFIG commands, the 
resulting RAM configuration would be: 



0, Physical = 
one sided, 

1 , Physical = 
one sided, 

2, Physical = 
one sided, 

3, Physical = 
one sided, 

4, Nil. 

5, Nil 

6, Nil 

7, Nil 



1, 5" Floppy, double density, 
one volume, step rate =■ 06 mS. 
0, 5" Floppy, double density, 
one volume, step rate = 06 mS. 

2, 5" Floppy, double density, 
one volume } step rate = 06 mS. 

3, 5" Floppy, double density, 
one volume, step rate = 06 mS. 
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Suppose you have three drives: DRIVE =-- 40 tracks, DRIVE L = 'tO tracks, 
DRIVE 2-80 tracks, and you wanted to copy information between several 40 
track diskettes. % Sometimes the -lata is &nin& La one direction, and 
sometimes it is going in the other direct Lou. You could use VFU/CMD to copy 
from DRIVE to DRIVE L, and DRIVE I to DRIVE 0. However, you do not want 
to continuously exit VFU/CMD (insert your system diskette into logical 
drive 0) to see the files on each di.sk. You could use SKIP on DRIVE 2, but 
any time a write is required for tho. diskette in DRIVE 2, it would have to 
be swapped with the diskette in DRIVE L. Never write to a diskette in a 
drive with SKIP active. Therefore, our solution would be (1) assign logical 
drive 2 to physical drive 0, (2) assign logical drive to physical drive 
2, then (3) SKIP logical drive 0. 



(1) CONFIG 2(P=0)<ENTER> 



:0, Physical = 
one sided, 

:1, Physical = 
one sided, 

2, Physical = 
one sided, 

3, Physical = 
one sided, 

4, Nil 

5, Nil 

6, Nil 

7, Nil 



0, 5" Floppy, double density, 
one volume, step rate = 06 mS, 

1, 5" Floppy, double density, 
one volume, step rate = 06 mS. 
0, 5" Floppy, double density, 
one volume, step rate = 06 mS. 
3, 5" Floppy, double density, 
one volume, step rate = 06 mS. 



(2) CONFIG 0(P=2)<ENTER> 



:0, Physical = 
one sided, 

:1, Physical = 
one sided, 

:2, Physical = 
one sided, 

3, Physical = 
one sided, 

4, Nil 

5, Nil 

6, Nil 

7, Nil 



2, 5" F 

one vol , 

5" Floppy 
volume 



I, 
one 

0, 



Floppy, double density, 
lume, step rate = 06 mS. 
Floppy, double density, 
lume, step rate = 06 mS. 



step 

do 

tep 



_ 7 

0, 5" Floppy, double 
one volume, step rai 
3, 5" Floppy, double 
one volume, step ral 



.<_ J.' «. (i !_.T. — \J\J lili.) < 

double density, 
:ep rate = 06 mS. 
"\e density, 
: = 06 mS. 



(3) SKIP 0<ENTER> 

Now move the system diskette to physical drive 2, and copy between logical 
drive 1 and logical drive 2, without swapping diskettes. 

EXAMPLE: 

COPY DATA/TXT: 1 to :2<ENTER> 
COPY MEMO/TXT: 2 to : 1<ENTER> 

If you made an 80 track system diskette, then step three could be 
eliminated by placing your 80 track system diskette into DRIVE 2. 
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w =» write protect condition. The user can change the write protect 
condition of a diskette without removing the diskette and applying/removing 
the write protect tab (write enable tab for 8" floppies). 



EXAMPLE: 



CONFIG 2(WP)<ENTER> 
CONFIG 2(WE)<END£R> 



{write protect the disk in logical drive 2} 
{write enable the disk in logical drive 2} 



^ 



N = nil logical drive. This parameter will remove a logical drive from the 
system. It is useful for a setup with only two drives, and the user doesn't 
want MULTIDOS to contiuously search 4 drives when looking for a filespec. 
If a physical drive is not in the system, then the logical drive assigned 
to it should be NILed. 

EXAMPLE: 

CONFIG 2(N)<ENTER> 
CONFIG 3(N)<ENTER> 

:0, Physical = 0, 5" Floppy, double density, 

one sided, one volume, step rate = 06 mS. 
:1, Physical » 1, 5" Floppy, double density, 

one sided, one volume, step rate = 06 mS. 

2, Nil 

3, Nil 

4, Nil 

5, Nil 

6, Nil 

7, Nil 

To reverse the effects of N, simply assign the logical drive to a physical 
drive: 



EXAMPLE : 



CONFIG 2(P=2)<ENTER> 

:0, Physical =0, 5" Floppy, double density, 
one sided, one volume, step rate = 06 mS. 

:1, Physical =1, 5" Floppy, double density, 
one sided, one volume, step rate = 06 mS. 

:2, Physical =2, 5" Floppy, double density, 
one sided, one volume, step rate - 06 mS. 

:3, Nil 

:4, Nil 

:5, Nil 

:6, Nil 

:7, Nil 



A 
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/ 



k ■ number of sides, and v ■ volume. The k parameter defines the number of 
surfaces to be accessed in the logical drive. If you have a two-headed 
drive, then perhaps you would like to treat this driv< 
volume drive. 



re as two-sided single 



EXAMPLE: 



CONFIG 1(SI=2)<ENTER> 

:0, Physical = 0, 5" Floppy, double density, 

one sided, one volume, step rate = 06 mS. 
:1, Physical =1, 5" Floppy, double density, 

two sided, one volume, step rate = 06 mS. 

2, Nil 

3, Nil 

4, Nil 

5, Nil 

6, Nil 

7, Nil 

This configuration would access drive 1 as a single logical drive with one 
directory (256 file capacity) and each track would have 36 sectors. This 
configuration will be compatible with LDOS and NEWDOS/80. The single volume 
method permits a very large data base (710K for an 80 track data diskette) 
to occupy one logical drive. 

However, there is an alternate configuration method for two-headed drives. 
EXAMPLE: 

CONFIG 1(V=2)<ENTER> 

:0, Physical = 0, 5" Floppy, double density, 

one sided, one volume, step rate = 06 mS. 
:1, Physical =1, 5" Floppy, double density, 

two sided, two volume, step rate = 06 mS. 

*• • 1 "i JL JL 

3, Nil 

4, Nil 

5, Nil 

6, Nil 

7, Nil 

The two volume method places two directories (file capacity of 128 each) on 
the diskette. The directory on side (the side readable on a single headed 
drive) would be accessed by the logical number without any additional 
arguments. i.e. DIR :1. The directory on side one (the side not readable 
with a single headed drive) would be accessed by placing an apostrophe, ', 
immediately behind the logical drive, i.e. DIR :1". The two volume method 
may be desirable for diskette portability of the data on side to be 
accessed in a single headed drive. 
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s = stepping rate. The s parameter sets the stepping rate for the logical 
drive indicated. The stepping rate, also referred to as the track to track 
access* speed, should not be set to a faster rate than the manufacturer's 
specification. The values accepted for floppies are 6, 12, 20, and 30. The 
actual stepping rates will be set as Indicated by the table below: 

for 5 1/4" floppies 



MODEL I 






MODEL III/4 


single densi 


ty 




MAX -80 






MODEL 


I double density 


1771 FDC 






179X FDC 


12 ras 






6 ms 


12 ms 






12 ms 


20 ms 






20 ms 


40 ms 






30 ms 



CONFIG (ST=6)<ENTER> 

CONFIG (ST=12)<ENTER> 

CONFIG (ST=20)<ENTER> 

CONFIG (ST=30)<ENTER> 

For 8" floppies, the indicated values and actual stepping rate will be half 
the 5 1/4" values, although the only CONFIG input values accepted are 6, 
12, 20, and 30. 

m = media type. MULTIDOS can have the configuration set for 5 1/4" floppies 
(5) or 8" floppies (8). In order to use the hard disk configuration (H), a 
hard disk driver will be needed. MULTIDOS does not have the needed driver, 
but the technical section should provide the necessary information to 
interface a hard disk driver with the DCT. 

X = write the current RAM configuration to logical drive 0. The "X" 
parameter is used to save the current RAM configuration for future 
power-up/reboots. Changing a CONFIG parameter value does not record the 
change to the diskette in logical drive unless the "X" parameter is also 
specified. 

EXAMPLE: 

CONFIG 1(SI~2)<ENTER> 

This sets up logical drive 1 for two side operation, but does not save the 
configuration. 

EXAMPLE: 

CONFIG (X)<ENTER> 
This writes the current RAM configuration to the disk In logical drive 0. 
EXAMPLE: 

CONFIG :1 (SI=2,X)<ENTER> 

This sets up logical drive 1 for two sided operation, and saves this 
configuration to logical drive for future power -up/ re -boo ts . 



J 
J 



) 
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DATE Set or display the .late stored in RAM. I 

DATE[ mm/dd/yy]<ENTER> 

DATE will set the date stored in RAM to min/dd/yy as entered. If no 

arsuments are enrerpd_ DATF. rphnnic t-h^ *1~. ."-a ci-orr.H in RAM. I 



arguments are entered, DATE returns the dat^ stored in RAM. 
EXAMPLE: 

DATE 12/25/84 {Set RAM date to December 25, 1984} 

DATE 11/18/83 {Set RAM date to November 18, 1983} 

DATE<ENTER> {Display current date stored in RAM} 



PATCH SYSRES/SYS (REC=8) T=230.2>62.2<ENTER> 

Once this patch is applied, the DDAM (D) function is defeated. 

To reverse this patch: 

PATCH SYSRES/SYS (REC=8) T=62.2>230.2<ENTER> 

DEAD Software power -up. (MODEL I/MODEL III only) 

DEAD<ENTER> 
All memory from 4000H upward will be set to 00, and the system will reset 



l 
] 



DDAM Modify single density directory Data Address Marks. (Model I only) 

DDAM[ [:]d] (U or D)<ENTER> 

d = logical drive number 

U = USER DEFINED (used by TRSDOS, NEWD0S/21, etc) 

D = DELETED (created/used by DOUBLE density controllers) 

DDAM alters the Data Address Marks on a single density diskette's directory L 

sectors. The address marks placed on a single density diskette by MULTIDOS t 
cannot be easily read by TRSDOS, NEWD0S/21, and ULTRADOS. If a write is 

necessary to a single density diskette, use DDAM to convert the address . 

marks after writing, if this diskette is to be read by TRSDOS, NEWD0S/21, _ I 

or ULTRADOS, etc. "I 

The DELETED DATA MARK is used for MODEL I to/ from MODEL III, MAX-80, and » 

MODEL 4 compatibility. If MODEL III, MAX-80, or MODEL 4 compatibility is \ 

not necessary, and "alien" system compatible address marks are desired; * 
then patch a backup system diskette (MODEL I ONLY!!!) as follows: 



1 
J 
J 
J 

) 
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DEBUG Real t Lme debugger. 

DEBUG [ switch ]<ENTER> 

DEBUG is a real time debugging package to use with machine language 
programs. DEBUG will examine and alter the contents of RAM or the Z-80 
registers, jump to a specified address and begin execution with optional 
breakpoints, and single step 7.-30 . instructions in RAM or execute Z-80 CALLs 
from RAM. Since DEBUG loads Into the overlay are of RAM (4D00H to 51FFH), 
DEBUG cannot be use with MULTtDOS overlays or utilities which load below 
5200H. (BACKUP/CMD, CAT/CMD, F0RMAT/CM1), RS/CMD, VFU/CMD, and ZAP/CMD) 

Once the debugging facility is enabled - via DEBUG (ON) - it does not load 
and execute until an executable program, with protection level of less than 
EXEC, is loaded and before the first instruction is executed, or 
<SHIFTXBREAK>, <LEFTXSH1FTXBREAK> MODEL HI/MODEL 4, is pressed. When 
DEBUG is initially loaded, if the display is blank, press <0> to enable one 
of three display formats: 



[1] Register display only - on the right hand side on the screen, 



{Debug pokes VIDEO refresh RAM and does use the 
{display routine to place data into the VIDEO. 
{Therefore, while debugging a program with out- 
{put directed to the display, the user can use 
{format [1] to keep abreast of display output 
{while debugging a program. 

{ 

{The <CLEAR> key is routed through the display 
{routine to reset the VIDEO from a WIDE display 
{or erase any extraneous data present on the 
{display when Debug is entered with the display 
{set to format [11. 

{ 

{Debug will function with the display disabled. 



AF 019B 
S H NC 
BC 0020 
DE 0180 
HL 4009 
AF'0044 

Z P 
BC'0160 
DE'0001 
HL',7000 
IX 4015 
IY 5180 
SP 41EA 
PC 0083 



[2] Register display with indirect RAM plus any 64 -byte "page" of RAM. 

AF 01 9B S H NC 

BC 0020 C300 00C5 0604 1842 C368 4311 1540 18E3 B.hC.G.. 

DE 0180 0EFF 0C0F 30FC 7D07 0707 A957 DD4E 0528 0.}....W.N.( 

HL 4009 0C00 1040 2000 0000 0080 0000 010E 4B00 ...@ ,K. 

AF'0044 Z P 

BC'0160 00E6 81EE 8120 08DD 7E05 EE10 DD77 05AF ~....w.. 

DE'0001 2E06 1740 C32D 407E E3BE 23E3 C200 00C3 . . .@. -@~. .// 

HL'7000 C4C5 C2D5 C720 2020 5265 616C 2074 696D Real tiai 

IX 4015 010E 4B00 0020 8F00 07E5 0200 3C00 0000 ..K <... 

IY 5180 43FF C343 C7C4 63FF CD63 C706 02F7 D302 C..C..c..c 

SP 41EA 0B07 8051 1843 1540 4F4F 4C00 9105 1843 . . .Q.C.0OOL. . . .C 

PC 0083 DDE1 FDE1 E1D1 C1C9 F1D5 E5FD E5DD E5D5 

0083 DDE1 FDE1 E1D1 C1C9 F1D5 E5FD E5DD E5D5 

0C93 DD21 8300 DDE3 F5AF C93A E837 E6F0 EE30 . ! :.7...0 

00A3 C90F 380F 0F38 090F 3803 C3E0 00C3 E000 ..8.. 8.. 8 

00B3 C3E0 00C3 E000 0F30 E80F 380B OF38 0E0F 0..8..8.. 
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[3] Full screen, 256-byte "pag<3" of RAM. 



Table of codes for all the flag bits: 



Bit status 


If set 


7 Sign 
6 Zero 


S 
Z 


5 Unused 

4 Half -carry 

3 Unused 

2 Parity/overflow 

1 Add/ Sub tract 

Carry 


space always 

H 
space always 

P 

N 

C 
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4400 3E10 EF00 003E 40EF 56F5 3i.L9 EFC3 5504 > >@.V.>...U. 

4410 C3D1 02C3 CE02 C362 043E C7EF 31290 EF28 b. >..>..( 

4420 3E12 EF02 3E42 EFA0 3E13 EF00 3E43 EF00 >. . .>B. .>. . .>C. . 

4430 C3B2 4AC3 D243 C311 48C3 2848 C327 48C3 . . J. .C. .H. (H. 'H. 

4440 8C47 C3AB 47C3 9347 C382 4718 26C4 434F .G. .G. .G. .G.& .CO 

4450 47C3 A104 1820 C3DI 43C3 C043 12601 C33A G C..C...: 

4460 46C3 0302 C3EE 473E 57EE AF18 17C3 B206 F G>W 

4470 C3C9 063E 50EF 3E80 EFC9 0034 FDCB 0166 ...>P.> 4...f 

4480 C0C3 8546 C63B 328F 447E 23FE 03C8 CD33 ...F.;2.D~// 3 • ~ 

4490 00FE 0D20 F4C9 2F32 EC37 C506 1410 FECI /2.7 f 

44A0 C9DD 660D DD6E OCDD 7E08 C9CD DA44 FDCB . .f . .n. .~. . . .D. . ' 

44B0 0166 C230 40CD 8145 E61B CD96 44CD 3446 .f.0@..E D.4F 

44C0 3AEC 370F 30F7 C3BD 46C3 D245 C300 02C3 :.7.0...F..E 

44D0 B74B C33A 04C3 3D03 954B 79C3 7946 C3CD .K. : . .=. .Ky .yF. . | 

44E0 46C3 CA46 AFC3 D946 C348 4AC3 D746 C335 F. .F. . .F.HJ. .F.5 

44F0 4AC3 1D4A C3DB 46C3 944A C3E1 48C3 1949 J. . J. .F. . J. .H. . I 

I 
I 

In the register display formats ([1] or [2]), DEBUG displays all the Z-80 

registers, organized for Interpretation either as two 8-bit registers or as 

16-bit register pairs. Since most programs use several sets of register . t 

pairs as indirect pointers or indexing registers, 16 bytes of indirect data » 

are presented with each register pair in format [2]. Each of the flag 

registers is shown with an ASCII representation of Its flag bits. For the . 

flag registers, the hex contents is displayed, along with a bit -by -bit | 

alphabetic code which makes it easier to interpret the flag status. For * 

example, bit (rightmost bit) Is the carry flag, the alphabetic code shows 

an C in that position whenever the carry flag is "set". i 
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DEBUG Commands 



Commands are executed as soon as the specified command key is pressed, or 
when <SPACE> or <ENTER> Is pressed, as indicated below. Ml values entered 
must be hexadecimal without th« "H" suffix. 



Command 
C 

Dqqqq 
E 



Terminator 
Required 

none 

<SPACE> 
none 

none 



G[jjjj[,kkkk]]<ENTER> 



M[cccc] 



none 
<SPACE> 



Operation Performed 

Single -steps next RAM instruction, with CALLS 
executed in full. 

Sets memory display starting address to qqqq. 

Produces continuous "C" commands until 
<SHIFTXSPACE> is pressed. 

Disables display formats. (Current screen contents 
is unaffected) 

Place jjjj in PC register and executes with 
optional breakpoint at kkkk. 

Single -steps next RAM instruction. 

Sets the current modification address to cccc. 
Modification information will be displayed in the 
lower left of the screen. If cccc is currently in 
the display, it will be overlayed by a transparent 
cursor. If cccc is omitted, the last modification 
address will be used for cccc. 



none 



Produces continuous "I" 
<SHIFTXSPACE> Is pressed. 



commands 



until 



Enables the display formats. 

Set display to register only - format [1].* 

Loads register pair rp with the value aaaa. 

Sets display to previous format [2] or [3].* 

Sets display to full screen - format [3].* 

Dynamic display update until <SHIFTXSPACE> is 
pressed. 

none Sets display to register format [2].* 

* DISPLAY FORMAT IF DIPLAY IS ENABLED VIA COMMAND "0". IF COMMAND "F" WAS 

ISSUED, DISPLAY FORMATS MAY BE CHANGED PRIOR TO A 
COMMAND "0". 






none 


P 


none 


Rrp aaaa 


<SPACE> 


Q 


none 


S 


none 


U 


none 



X 



X 



J 
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/ 

up-arrow none Decrements memory display by lf>d, LOH bytes. 

<SH>up-arrow none Decrements memory display by 4096d, 1000H bytes. ' 

down-arrow none Increments memory display by 16d, 10H bytes. 

<SH>down -arrow none Increments memory display by 4096d, 1000H bytes. ' 

right -arrow none Increments memory displav by 1 byt^. 

i 
<SH>right-arrow none Increments memory display by 256d, 100H bytes. 

left-arrow none Decrements memory display by 1 byte. 

<SH>left-arrow none Decrements memory display by 256d, 100H bytes. 



[f an error is made while typing an address, key in the correct 
.mmediately after the incorrect address. DEBUG will only look at t\ 
our characters entered. y u 



I 
I 

EXAMPLE: 

DFAE944<SPACE> j 

Will display the page of memory starting with address E944H. x 

"I 

The M" command detail.... 

thL «5JrF? OU Ti,y 1Sh . t0 u lter the content s of a memory location, key Mcccc l 

then <SPACE>. This sets the memory modification address to cccc and outs * S 

SS&tE! ass *?oT. « il1 be ---> -» ™^^ I 

Telt-arrow™ S^rl*^ 1 ^ ^ ™ ^eS^ch^ed!";^ £e l 
bv 16d ?OH fi? IS J up-arrow will decrement the modification address 

d OH ; P n hG down-arrow will increment the modification address by L 

16d, 10H. Pressing any non-hex key will exit the modify memory mode. * J 

To disable DEBUG, key in: 

DEBUG (N)<ENTER> | 

or DEBUG (NO)<ENTER> J 

or DEBUG (OFF)<ENTER> 
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DEVICE List current I/O devices. 

This command lists the defined I/O devices and their routine entry points. 

^.< eVl Sf \ S LINKed or ROUTEd , then DEVICE indicates the LINK or ROUTE 

condition. The defined I/O devices are: KI = keyboard, DO = video display, 

i T line P rlntP -«V SI - RS 232 -C input (Model III, MAX-80, and MODEL 4 

only), and SO = RS 232-C output (Model lit, MAX-80, and MODEL 4 only). 



EXAMPLE: 



DEVICE<ENTER> 

KI = I at X'4BC4' 
DO = at X'4275' 
PR = at X'4275' 
SI = I at X'4C7C 
SO = at X'FFOO', 



routed to DO 
routed to :1 



The keyboard is an input device with the routine starting at RAM address 
4BC4H. The display is an output device with the routine starting at 4275H. 
The printer is routed to the display. The RS 232-C input routine starts at 
4C7CH, and the RS 232-C output is routed to a file on logical drive 1. 



") 



DIR Display a specified disk's directory. 

DIR[mask] [ [ [ : ]d] ( [ AJ [ , I] [ ,P] [ ,R] [ ,S j) ]<ENTER> 



The DIR command displays the file directory for a single drive, including 
the drive number, disk title, disk date, the number of logical tracks the 
number of physical tracks, the free space in granules, the free space in 
kilobytes (1024d), and names of all visible and non-system files on the 
disk in ascending alphabetical order. 

The "mask" is used to limit the display to selected files which match the 
mask . The mask" is optional, and has two wildcards. The "?" character is 
used as a substitute for any character, and the "*" character is used as a 
*£ „*» substitute for any character. The "mask" option does not override 
the I or S parameters discussed on the next page. 



EXAMPLE: 



USER INPUT 



DIR */CMD<ENTER> 
DIR */ASM<ENTER> 
DIR B*/*<ENTER> 
DIR ??A*/*<ENTER> 
DIR */<ENTER> 
DIR ???/*<ENTER> 



FILES DISPLAYED 



with an extension of "/CMD". 

with an extension of "/ASM". 

with a "B" in the first position. 

with an "A" in the third position. 

without an extension. 

with 1, 2, or 3 characters in the filename 



N 
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At the MULTIDOS command level, DIR can be invoked with one keystroke. 
key pressed represents the logical drive desired. The keystrokes are:" 



The 



"0" * DIR :0 
"1" = DIR :1 
"2" = DIR :2 
H 3 M * DIR :3 
<SHIFT>0 = DIR :0' 
<SHIFT>1 = DIR :1' 
<SHIFT>2 = DIR :2' 
<SHIFT>3 = DIR :3" 



{MAX-80 and MODEL 4 only} 



The key must be the first keystroke after <ENTER> or <BREAK> 
MODEL I/III or in the first position for the MAX -80 and MODEL 4. 



for the 



The "A" parameter will display, for each file, the date of the last update 
(Date), the physical allocation, including the end of file sector and the 
last byte within the end of file sector (Eof), the logical record length 
(Lrl), the number of logical records (Lrec), the number of segments - 

Sf n n 8 ??y^ 8 Ffi!mA 8 (Se8) < and ,o th ?.f lle /2i Z ?/ ln ^nules (Grans). A maximum 
of 11 files (64X16 screen) or 19 fiLes (80X24 screen) will be displayed at 

° ne 5 lrae ' ?o dis P la y the next file, press <SPACE>; or to display another 
page of files, press <ENTER>. F y 



EXAMPLE: 



DIR ZAP/* (A)<ENTER> 

MULTIDOS 12/01/84 35 log 35 phy cyls 32 grans 48.00 K 
Filename Date Eof Lrl Lrec Seg Grans 



ZAP/CMD P 



11/26/84 



31/117 256 



32 



The file ZAP/CMD was last updated on 11/26/84, uses 31 full sectors and 117 
bytes in the 32nd sector, has a logical record length of 256, consumes 32 
sectors in one segment consisting of 6 contiguous granules. 

^hlTf??!^™* W A} 1 di fPj a y the ., files wit h the "I" attribute as well as 
visible files. The files with an "I" attribute are indicated with an "I" 
after the filename. 



EXAMPLE: 



DIR :2(I)<ENTER> 

2 MULTIDOS 12/01/84 35 log -35 phy cyls 32 grans 48.00 K 



BACKUP/CMD I 
C0PY/CMD I 
GR/CMD 
RS/CMD P 
ZAP/CMD P 



BASIC/CMD I 
DBLFIX/CMD 
MEM/CMD P 
SP00L/CMD 



BBASIC/CMD I 
DDT/CMD 
MEMDISK/CMD 
TAPE/CMD 



CAT/CMD P 
FORMAT/ CMD I 
PRT/CMD 
VFU/CMD P 



/ 



t 
i 
I 
J 
J 
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The "P" parameter will direct 
display, and the directory 
displayed. 
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the output to the printer as well as the 
listing will scroll until the last file is 



EXAMPLE: 



DIR 3(A,P)<ENTER> 

The following type of output will go to both the display 
and the printer: 

3 MULTTDOS. 12/01/34 35 log 35 phy cyls 32 grans 48.00 K 
Filename Date Eof Lrl Lrec Seg Grans 



^ 



CAT/CMD P 

CDIR/CMD 

DBLFIX/CMD 

DDT/CMD 

FMAP/CMD 

GR/CMD 

HELP/CMD 

LO/CMD 

MEM/ CM D P 

MEMDISK/CMD 

PRT/CMD 

RS/CMD P 

SP00L/CMD 

TAPE/CMD 

VFU/CMD P 

ZAP/CMD P 



07/31/84 
10/20/84 
06/30/84 
07/13/84 
10/14/84 
07/25/84 
09/24/84 
11/17/84 
07/13/84 
10/29/84 
08/05/84 
06/30/84 
08/04/84 
07/13/84 
09/02/84 
11/26/84 



9/137 
2/117 
2/64 
4/32 
4/176 
1/3 
23/95 
8/209 
1/195 
3/176 
3/231 
4/227 
4/172 
7/68 
17/102 
31/117 



256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 



10 
3 
3 
5 
5 
2 

24 
9 
2 
4 
4 
5 
5 
8 

18 

32 



1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 



2 
1 
1 

1 
1 
1 
4 
2 
1 
1 
1 
1 
1 
2 
3 
6 



The "R" parameter will display removed files, provided the directory entry 
location was not overwritten. (CDIR/CMD clears out a removed file's 
filename 7 ^^ ' Rem ° ved files are indicated by having a "R" after the 

The "S" parameter will display the system files as well as visible files. 
System files are indicated with a "S" after the filename. VlslDle tlies « 



EXAMPLE: 



DIR */?0L 1(S) 

1 MULTIDOS 12/01/84 35 log 35 phy cyls 32 grans 48.00 K 

D^W/n'o/T S S??^^ S Close/DOL S Command/DOL S ' 

Debug/DOL S BDIT/BOL S ERROR/BOL S Error/DOL S 

Minidos/DOL S Open/DOL S PACK/BOL S RENUM/ROT <s 
UNPACK/BOL S UTIL/BOL S KENUM/BOL S 



J 



J 



A 
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DO Substitute disk file for keyboard input. 

DO filespec<ENTER> 

DO will execute *the filespec entered. Usually the filespec has been 
previously created with the BUILD command. The DO command will add the 
extension "/IDO" to the filespec, if the Eilespec was entered without an 
extension. DO reads the contents of, TOPMEM, creates a 290d, 122H byte 
buffer from TOPMEM down, then resets TOPMEM after the "DO" file is 
complete. If high memory is to be reserved for an application with/by the 
"DO" file, then TOPMEM should be set BEFORE the "DO" file is executed. If 
the "DO" file is to be activated during power-up/re -boo t, use the multiple 
command AUTO, or the multiple AUTO command to accomplish this task. 

EXAMPLE: 

AUTO TOPMEM xxxxx,DO STARTER<ENTER> 
or AUTO TOPMEM xxxxx<LF> 
DO STARTER<ENTER> 



DUMP Transfer RAM contents to a disk file. 

DUMP filespec (START=ssss ,END=eeee[ ,TRA=tttt] [ ,CIM] [ , TITLE ] )<ENT£R> 

ssss = starting address eeee = ending address 
tttt = optional transfer address. 

DUMP will transfer the contents of memory starting at "ssss" and ending at 
"eeee" to the filespec, and will add the extension "/CMD" to the filespec 
If none was entered and the "CIM" parameter is not specified. The transfer 
address, "tttt", will default to 402DH. The transfer address specifies the 
entry point for execution of the file. 

EXAMPLE: 

DUMP BUG (START=X'FD00',END=X'FFFF',TRA=X'FE00')<ENTER> 

The contents of memory locations FDOOH through FFFFH will be transferred to 
a disk file named BUG/CMD. When the command 3UG<ENTER> is entered, MULTIDOS 
will load memory from FDOOH to FFFFH and begin execution at FEOOH. 

The "TITLE" parameter will write a TITLE comment block (up to 12 
characters) on the first sector of the file created with the DUMP command. 
The parameter "CIM" (core image memory) specifies direct transfer to disk 
sectors without load marks. The "CIM" parameter is used to create a disk 
file with an exact copy of RAM, and is not an executable file. 

EXAMPLE: 

DUMP DCT (START=X'4500',END=X'457F',CIM)<ENTER> 

The contents of memory locations 4500H through 457FH will be transfered to 
a disk file named DCT/CIM. 
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LIBRARY COMMANDS 
FORMS Set or display printout format parameter values. 

^ FORMS[ (I[ ,M=m] [ ,W=w] [ ,T=t] [ ,P=p] [N=n] [ ,L] [ ,C] [ ,OFF] [ ,X] )]<ENTER> 
I = intiaiize line counter and character counter to zero. 

w - i?^h m nf 8 i n \ (8 ? aC ? 8 ° n ^ l eU hand slde before Printing begins) 

t : 1 Lh J (Pinter width should be equal to or greater than "m+w") 

c. - text length, (number of printed lines of text) 

P = page length, (paper length in lines) 

n = the number of nulls (value-0) sent after each line feed (decimal 10) 

L - issue a line feed (decimal 10) after each carriage return (decimal 13) 

L - route formatted printer output to RS-232-C (not MODEL I) 

OFF = sets m to 0, w to 255, t to 60, p to 60, n to 0, L off, C off, 

X = sav a ?rnLJ n f 3nd cha f acter counters to 0. (0FF,X removes PRT "clone") 
save current forms settLng to the system diskette for default parameter 

not Hp Sri?. q V en 5 P° w ^- Up/re "!? 00tS - The diskette in drive zero must 
not be write protected. (Saves a "clone" of PRT/CMD - MODEL I/III) 

Ixceeds'X 11 ^ 1 "^ IE deterrain «V y the "m" and "w" values. When a line 
carriage returnTdecLl ?lt , two , valu ^» F0 ™S will automatically insert a 
set to 255 I n ( S -IV tG f tart a neW line ' Tf the " w " Parameter is 
a a r likrl f In t WlU n0t lnSert ca rriage returns. Most printers have 
a paper width of 80 characters. If you want to punch holes on the left side 
and not punch into your printed text, set theV parameter to 5 and the 
w parameter to 75 (80 - 5 = 75). l r co D > anfl the 

EXAMPLE: 

FORMS (M=5,W=75)<ENTER> 
The page length, the length of the form in lines is ronfrnllpH h„ m« » » 
U- C a ' r^M" , t „,f!"~ t «-c F ?f.«»-P 1 «. in . P"""ng on standard 



bottom, set the d parameter m &(*> (^ v i i cc\ , . .. * ines ac the 

58 (66 - 4 - 4 - 58)! ( 66) ' and the fc parameter to 

EXAMPLE: 

FORMS (T=58,P=66)<ENTER> 

When you decide an application requires forms control be surp t-n «•* 

form to the correct position to start printing and initialize tL ?< y ° U J 

character counter to zero by using the "I" paLter! ^ 

EXAMPLE: 

FORMS (I,M=0,W=80,T=60,P=66) 

}' tJ 6 J" 1 ? 6 3nd character counters are set to zero. 

I. The left margin is set to zero. 

3. The print width is 80 characters. 

4. The printed text length is 60 lines. 

5. The page length is 66 lines. 
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FORMS will interpret a decimal 11 as a line feed without a carriage return 
(vertical tab one line). Decimal 11 can be used to send line feeds to 
certain printers which do not respond to multiple line feed characters. 
When ESC, decimal 27-, is encountered, FORMS will not count this or the next 
character in the page width, i.e. LPRINT CHR$(27 ) ;CHR$(12) will send" both 
codes directly to the printer without generating a form feed, and leave the 
character counter where it was before this ESC pair was sent to the 
printer. 

The RAM address for the FORMS parameter values are: 



Text length. 


(T) 


4028H 


Line counter. 




402911 


Width of text. 


(W) 


402 AH 


Character counter. 




402BH 


Print lines per page. 


,(P) 


402CH 



Whenever the FORMS command is entered the current values are echoed on the 
display. However, if the "I" or "OFF" parameter is specified, the display 
will not echo the settings. This is useful for initializing the FORMS 
parameters from within SUPERBASIC without messing up the display. 

To list the current parameter values, key: 

F0RMS<ENTER> 

NOTE: MODEL I/III MULTIDOS requires PRT/CMD executed before FORMS can be 

used. However, if a FORMS ( ,X) is performed, then FORMS will be 

available upon power-up/re -boot. 



FREE Display the free space on all mounted disks. 
FREE<ENTER> 

FREE displays the drive number, the disk's name and date, the number of 
free file spaces, the number of free granules and the equivalent K bytes 
(1024 bytes) on each mounted disk. In addition, FREE will total all the 
free file spaces and available disk space in kilobytes. 
****** For you HARD disk users, FREE will total up to 999 Meg!! ****** 



HELP Provide a brief explanation of a MULTIDOS LIBRARY command. 
HELP[ command ]<ENTER> 

HELP will assist you in using the MULTIDOS LIBRARY commands along with the 
format required to execute each command. If the command is omitted or 
incorrect, HELP will list all of the available commands in the HELP file. 
This is a library command for the MAX -80 and MODEL 4 only. The MODEL I and 
MODEL III version has a command file HELP/CMD which performs the same 
function as the MAX -80 and MODEL 4 library command HELP. 
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LIBRARY COMMANDS 
KEYBRD Set or display keyboard attributes. 

(1) KEYBRD[ ([C=cc][,l.=sw])]<ENTER> 
.(2) KSYURD[ ([C=cc][ ,L=sw][ ,W=sw][,E=sw])]<ENTER> 

cc = cursor character value (0 to 255 or X'OCT to X'FF') 

L = UPPER/lower case at power-up/re-boot 

W = 80 column display at power -up/ re -boot 

E = graphic character conversion for use with certain printers 

sw = Y, YES, or ON if the function is desired 

sw = N, NO, or OFF if the function is not desired 

(1) KEYBRD will establish the cursor character, and the character case on 
power-up/re-boot for the MODEL I and MODEL III. In addition, (2) KEYBRD 
will establish the video width, or graphic conversion [for EPSON (tm> 
printers capable of reproducing the TRS -80 ( tm) video graphic characters] 
on power -up/ re -boot for the MAX -80 and MODEL A. 

If a KEYBRD attributes is changed, it is updated on the system disk, but 
does not go into affect until a power -up/re -boot occurs. 

EXAMPLE: 

KEYBRD (L=N,C=176)<ENTER> 

This command will set the case to UPPER, and change the cursor character to 
176d on future power-up/re-boots by overwriting the current values on the 
system disk in logical drive zero. 

To list the current KEYBRD attributes, key: 
KEYBRD<ENTER> 



KILL Remove a filespec. 

KILL filespec<ENTER> 

KILL will reset the directory in use bit and deallocate the disk space used 
by the filespec, if the disk containing the filespec is not write 
protected. If a drivespec is not included in the filespec, MULTIDOS will 
search for the file in ascending logical drive order and remove it. 



LIB Display the MULTIDOS library commands. 
LIB<ENTER> 

This command lists the available library command for a full system disk. 
JS»„i \ r ™ y commands BLINK, BOOT, CLEAR, CLOCK, CLS , DEAD (MODEL I/III). 
DEBUG, LIB, LOAD, VERIFY, V6A (MAX-80/M0DEL A), and V80 '(MAX -80 /MODEL A) 
are contained in Command/DOL which uses RAM from AD00H to 51FFH. The rest 
of the MULTIDOS library commands operate in RAM from 5200H to 68FFH. 
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LINK Simultaneous output of output devices. 

LINK[ dvl [to] dv2]<ENT , -:R> 
LINK will link an output device (DO, PR or SO) to another output device. 
EXAMPLE: 

LINK DO to PR<ENTER> 
This will echo to the display anything going to the printer. 
EXAMPLE: 

LINK PR DO<ENTER> 

This will send to the printer every byte going to the video DCB, including 
control characters (decimal 1 to 31). The PRT/CMD file will fi%ter out 
specific control characters if you do not want them to do all kinds of 
things to the printout such as: start underlining, compress print, expanded 
print, form feeds, etc. (See PRT/CMD for details.) 

To un-LINK any or all LINKed devices, key: 

LINK<ENTER> 

If dvl is LINKed to dv2 , then dv2 cannot be LINKed to dvl, dvl cannot be 
ROUTEd to dv2, and dv2 cannot be ROUTEd to dvl. However If dvl is LINKed to 
dv2, and dv2 is LINKed to d^3, and dv3 is LINKed to dvl, the system will 
crash. 

LINK to a filespec can be accomplished by the indirect usage of the ROUTE 
command. To link the display to a filespec key: 

ROUTE PR to filespec<ENTER> 
LINK PR to DO<ENTER> 

This method is better than ROUTEing the display to a disk file, because it 
lets you see what you are doing. Now every byte (including control codes) 
going to the display will also go to the filespec. A subsequent LINK<ENTER> 
will stop sending to the filespec the information going to the display: 
however, a ROUTE <ENTER> is required to close the filespec. If ROUTE<ENTER> 
was executed first, then the display contents will also go to the printer. 
To filter out control codes going to the filespec key: 

FORMS (C)<ENTER> 

ROUTE SO to filespec<ENTER> 

LINK PR to DO<ENTER> 

The codes to filter out must be entered when PRT/CMD is executed. 

t 
If the RS-232-C is linked to the display, several of MULTIDOS utilities 
will be severely hampered. BACKUP/CMD, FORMAT/CMD, ZAP/CMD. Although 'these 
utilities will operate very slowly, the other functions will operate 
flawlessly. r 
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LIBRARY COMMANDS 



LIST Display disk file. 



LIST filespec[ ( [G] [ ,G 1 [ ,D] ) ] <KNTER> 

LIST will display the CUespeo's contents to the display. If the file 
contains control codes (decimal I to 31), LIST will suppressed the control 
codes unless the "C" parameter is specified. Graphic characters are 
suppressed unless the "G" parameter is specified. LIST can be terminated by 
pressing <BREAK> or suspended by pressing <SHIFT>@. To continue from a 
listing pause, press any other key except <SHIFT>@. 

The "D" parameter overrides the "C" and "G" parameters, and performs a 
sector by sector dump of the filespec, pausing after each full sector is 
displayed. Press any key to continue with the sector dump. When the last 
sector is reached, only the bytes within the last sector are displayed. 

LOAD Place an object file from disk into RAM. 
LOAD f ilespec<ENTKR> 

LOAD will transfer the filespec into RAM then return control to MULTIDOS. 
If the filespec loads between 4D00H and 51FFH, Command/DOL will load this 
area when control returns MULTIDOS. If the file loads between 5200H and 
68FFH, most library commands, if executed, will load in this area. 



PATCH Modify the contents of a disk file. 

{ ,U S™U ^H es P ec (REl>tm[,BYTR«yyJ) bl [ ; b2 ] [ ; b3 ] [ ; b4 ]<ENTER> 
(2) PATCH filespec (REC=nn) T= tl [ . t2 ] [ . t3]>bl I .b2 J [ b3 ]<ENTER> 

nn = physical record of filespec (NOTE: The first record is 0) 

yy = relative byte In physical record nn. 

bl, b2, b3, b4, etc. = DECIMAL value of replacement bytes. 

tl, t2, t3, etc. = DECIMAL value of target bytes. 

PATCH will change any disk file, regardless of the password protection 
level. The target or byte separator can be either a semicolon ";" or a 
period .". 



or 



EXAMPLE: 

PATCH CREF/BOL (REC-1) T=2 ; 245. 32>3 . 2A5; 48<ENTER> 

This will patch the file CREF/BOL to show the total references during a 
full reference listing. Format (1) is used when you know EXACTLY where to 
make the change. Format (2) is used when you know the target sequence 
occurs only ONCE in the physical record "nn". PATCH does not recognize 
logical record lengths, REC=nn must be the PHYSICAL record. 



"> 
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PRINT Print a message or the contents of ;i fiLe to the printer. 

(1) PRINT"message<ENrKlO 
or (2) PRINT f ilespec<ENTER> 

PRINT can print a message to the printer from the MULT [DOS command mode by 
placing a double quote immediately after PRINT is keyed in. 

EXAMPLE: 

PRINT"The directory of my special operating system. <ENTER> 

Will print: 

The directory of my special operating system. 

EXAMPLE: 

PRINT" "TEST NUMBER 1"<ENTER> 

Will print: 
"TEST NUMBER 1" 

PRINT will print the contents of the filespec to the printer. If the file 
contains control codes (decimal 1 to 31), PRINT will suppress the control 
codes unless the "C" parameter is specified. Graphic characters are 
suppressed unless the "G" parameter is specified. 



PROT 

PROT[ [:]d] [ (LOCK] [, UNLOCK] [, DATE J { ,PW] ) ]<ENTER> 

LOCK = assign MASTER PASSWORD to all user files 

UNLOCK = remove all passwords from user files 

PW = change the MASTER PASSWORD 

DATE = date all files to current RAM date used with LOCK/UNLOCK 

PROT can change the disk MASTER PASSWORD, lock - add master password to, or 
unlock - remove all passwords form all visible and non -system files on the 
disk. The drivespec referenced must not be write protected. 

EXAMPLE: 

PROT (LOCK, DATE )<ENTER> 

This will assign the MASTER PASSWORD to all user files, and redate all user 
files to the current RAM date. If no parameters are entered with PROT, you 
will be prompted to change the disk's name and the date. There is NO 
checking for a valid name or date; use what you wish! If you only want to 
change one of the name/date pair, simply <ENTER> for the one not to be 
changed. To prematurely exit this command, press <BREAK>. 

NOTE: The master PASSWORD on your MULTIDOS disk is PASSWORD. 
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LIBRARY COMMANDS 



RENAME Change filename. 



RENAME [//Jfilespecl [to] f ilespec2<ENTE R> 

This command will change the name of Cilespeci to filespec2. If the 
optional "If" is specified, then the renamed file's date will be changed to 
the current RAM date. Filespec2 will contain the protection level, 
password, and directory attributes of filespecl. RENAME will not duplicate 
a existing filename on the same disk, and will only change the primary HIT 
(Hash Index Table - see ZAP) byte. ZAP will complain if the renamed file Is 
in more than four segments - at least two HIT entries. 



RESET Reset I/O devices and restore TOPMEM. 
RESET<ENTER> 

RESET will un-LINK, un -ROUTE, remove all interrupt tasks, and restore 
TOPMEM to the power-up/re -boo t value. If a ROUTE to filespec is active, 
RESET will close the file, then un -ROUTE the device. 



^ 



RESTOR Recover a KILLed filespec. 

RESTOR filespec :d<ENTER> 

RESTOR will attempt to recover a removed file. If the file space on the 
disk has been re-assigned you will be notified of this condition and RESTOR 
will abort. The drive number is mandatory for RESTOR to work properly. 



ROUTE Redirect one device to another. 

(1) ROUTE [ dvl [to] dv2]<ENTER> 

(2) ROUTE dvl [to] filespec<ENTER> 

ROUTE will change the routine entry point of dvl to dv2's entry point. If 
format (2) is used, ROUTE will create a buffer in high memory and direct 
the output destined for dvl to the specified filespec. 

EXAMPLE: 

ROUTE PR to DO<ENTER> 

This will cause all bytes normally going to the printer to go to the 
display instead. 

To un-ROUTE all devices and close the filespec for format (2), key: 
ROUTE<ENTER> 



J 



A 
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SCREEN Dump the screen contents to the printer. 

SCREEN<ENTER> 
SCREEN will transfer the screen contents t«» the printer. 
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SETCOM Set or display RS-232-C, parameter values. (MODEL III only) 

SETCOM[ ( [BAUD=r] [ ,sel] [ ,WORD=w] [ ,ST0P=b] [ ,psw] [ , tsw] [ ,DTRJ [ ,RTS] ) ] <ENTER> | 

r = ?nnn 'olnn ^nZ^on^ '' -3 75 ' 110 ' 134 ' 150 > 300 > 600 » 12 °0» 1800, 

2000, 2400, 3600, 4800, 7200, 9600, or 19200. 1 

sel = parity selection, ODD or EVEN I 

w = Word leneth. Amant-oA ot- Q . <; c i ~_ o * 

1 



1 
1 



> 



=» Word length. Accepted are: 5, 6, 7, or 8. 
bb = Stop bits. Accepted are: 1 or 2. 

psw » Parity Switch. PE for parity enabled, and PD for parity disabled. 
n?o 7 e Transmi J t switch. TE = Transmitter enabled, TD = Transmitter disabled. 
DTR if entered sets DTR high, otherwise DTR will be set" low. 
RTS if entered sets RTS high, otherwise RTS will be set low. 

SETCOM<ENTER> will display the current RS-232-C settings. 

SKIP Read a 40 track disk in a 80 track drive. 

SKIP[ [:]d]<ENTER> 

d = drive number to read a 40 track disk in a 80 track drive. * 

SKIP will enable a 80 track drive to READ a 40 track diskette. If no drive \ 

number is specified, then all SKIP's are removed. J 

TIME Set or display time. 1 

TIME[ hh:mm:ssj<ENTER> 

hh = hour, mm = minute, ss = second ( 

EXAMPLE : 

TIME 22:21:00<ENTER> 
This will set RAM's time to 10:21 pra. 
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LIBRARY COMMANDS 

TOPMEM Set or display upper MIILTIDOS system memory. 

TOPMEM[ xxxxx]<ENTER> 

xxxxx = a decimal number from 28671 to 65535, 
or a hexadecimal number from 6FFFH to FFFFH. 

TOPMEM sets the upper limit of user free memory available to the operating 

system. This is useful if you have some high memory drivers to protect, 

because MULTIDOS programs, such as SUPERBASIC, and others check the value 
of TOPMEM and operate at that limit. 

EXAMPLE: 

TOPMEM BFFFH<ENTER> 
This will set the upper memory usage to BFFFH. 
EXAMPLE: 

TOPMEM 61439<ENTER> 

This sets the upper memory usage for MULTIDOS to 61439. 

TOPMEM without a value will display the current TOPMEM value in both 

hexadecimal and decimal. 

EXAMPLE: 

TOPMEM<ENTER> 
EFFFH, 61439 

VERIFY Reread a written sector. 
VERIFYf switch] <ENTER> 

VERIFY will cause all disk writes to be reread for parity. All direr rnrv 
writes are automatically verified. 7 directory 



V64 Set video width to 64 characters. (MAX-30 and MODEL 4) 

V64<ENTER> 
V64 will set the video width to 64 characters then clear the display. 

V80 Set video width to 80 characters. (MAX -80 and MODEL 4) 

V80<ENTER> 
V80 will set the video width to 80 characters then clear the disaply. 



J 
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SYSTEM UTILITIES 
BACKUP/CMD Duplicate a disk. 

^BACKUP[ A][[:]dl]][ to ] [ [ : ]d2 ]<ENTER> 

A « absolute format 
dl - source drive 
d2 = destination drive 

BACKUP will duplicate all files from one disk to another. The "A" option, 
If specified, will cause an absolute format and does not check or warn the 
user if the destination disk contains data. Source and destination logical 
drive numbers can be specified on the BACKUP command line. The source and 
destination logical drive numbers can be the same. If the logical drives 
are the same, BACKUP will prompt the user to mount the destination or 
source disk as required (swapping). To prevent accidental rewriting on the 
source disk, when swapping is required, manually write protect the source 
disk. 

BACKUP/CMD will take you through the easy procedure to duplicate a disk. 
After BACKUP/CMD is loaded and executes, the screen will clear and 

"" " 'MULTIDOS Disk Duplicator Program - Version X.X 

Ql • Which drive contains the source diskette? _' 

will appear. BACKUP is' waiting for a numerical response of to 7, or 0' to 
7' followed by <ENTER>. If the source drive number was specified in the 
| " BACKUP command line, then this query will be bypassed. 



I 
I 
I 
J 
J 



Respond with the logical drive number for the source disk. Next: 

Q2 'Which drive for the destination diskette? _' 

will appear. Again BACKUP is waiting for a numerical response of to 7, or 
0' to 7' followed by <ENTER>. If the destination drive was specified in the 
BACKUP command line, then this query will be bypassed. 

Respond with the logical drive for the destination disk. Next: 

Q3 'Press "ENTER" when the source disk is in drive X.' 

will appear. Where X is the response to the first query (Ql). Mount the 
source disk, if it is not already there, into logical drive X then <ENTER>. 

MULTIDOS will analyze the source disk for track count and density, then 
'The source diskette has YY tracks, in ZZZZZZ density. 

Q4 Track count for the destination diskette ( 18 to 96 )? 



J will appear. Where "YY" is the number of tracks on the source disk and 

"ZZZZZZ" is the density of the source disk. The destination disk will be 
formatted in "ZZZZZZ" density; however, you may specify the track count for 
the destination disk. If <ENTER> is the response for the track count, 
] BACKUP will use "YY" for the track count. 
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If the entered track count Is insufficient to copy all files, BACKUP will 
display: 

'Insufficient tracks to copy all CLI.es!' 

then revert to the third query (Q3). 

If the track count response Is acceptable, BACKUP/CMD will display: 

'Press "ENTER" when the destination disk is in drive W.' 

where "W" is the response to the second query (Q2). If the destination 
drive is the same as the source drive, you MUST swap the disks. If the 
destination disk was previously formatted and the ''A" option was not 
specified in the BACKUP command then the message: 

'Disk contains data. 
The disk name is DISKNAME, dated inm/dd/yy. 
Q5 Re-format this diskette (Y/N/Q)? __' 

will appear. If you want to reformat this disk, press <ENTER> or input a 
<Y>. If you want to bypass the formatting, input <N> - BACKUP will skip the 
formatting but verify the destination disk. If you want to abort BACKUP, 
press <BREAK> or enter <Q>. 

BACKUP does not check the destination disk for a density match with the 
source disk. If the destination disk had been formatted differently, you 
MUST respond <Y> to the fifth query (Q5). 

If the source drive and destination drive are the same, BACKUP will prompt 
the user to insert the source disk and destination disk as required. The 
swapping will continue as necessary until all the files are copied to the 
destination disk. 

After BACKUP has copied all files: 

'Completed, 
will be displayed. 
If either the source or destination disk was In logical drive 0, then 

'Insert SYSTEM <ENTER>' 

will also be displayed. This prompts you to insert a MULTIDOS disk to 
return to the state prior to entering BACKUP. 

The format pattern placed on the disks by BACKUP/CMD may be changed by 
zapping one to four bytes on BACKUP/CMD's first sector. Key ZAP<ENTER>, 
press <F>. Enter BACKUP/CMD to the Filespec prompt. When ZAP/CMD requests 
"Relative sector in file BACKUP/CMD ( to 0016/010H )....", press <ENTER>. 
Relative sector number zero of BACKUP/CMD will be displayed at this point. 
The format pattern bytes for double density are located in bytes 8EH/8FH, 
and the format bytes for single density are located in bytes 9EH/9FH. ; 
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Relative sector zero of BACKUP/CMD 



•B HEXOO 



10 
DR 20 

30 

40 
P TR 50 
/ 03 60 
C 03 70 

80 

D SE 90 

00 AO 

00 BO 

CO 
FILE DO 
0000 EO 
000H FO 



A 
C 

K 1 
U 



M 



057A 
2A20 
2A20 
2A20 
2A20 
2A20 
2A20 
2A2A 
4442 
534E 
5072 
656E 
6564 
6973 
6573 
6973 



4241 
2020 
2028 
436F 
2045 
436F 
2020 

4C20 
4720 
6573 
2074 
2EOD 
2069 
7469 
2069 



434B 
204E 
6329 
736D 
6C65 
7270 
204E 
2A2A 
4445 
4445 
7320 
6865 
736F 
6E20 
6E61 
6E20 



5550 
4F54 
2020 
6F70 
6374 
6F72 
4F54 
2A2A 
4E53 
4E53 
2245 
2003 
7572 
6472 
7469 
6472 



2020 
4943 
2031 
6F6C 
726F 
6174 
4943 
2A2A 
4954 
4954 
4E54 
0A43 
6365 
6976 
6F6E 
6976 



2031 
4520 
3938 
6974 
6E69 
696F 
4520 
2A2A 
5920 
5920 
4552 
6F6D 
2064 
6520 
2064 
6520 



3138 
2020 
3320 
616E 
6373 
6E2E 
2020 
0102 
3D20 
3D20 
2220 
706C 
6973 
302E 
6973 
302E 



347E 
202A 
202A 
202A 
202A 
202A 
202A 
0034 
6DB6 
E5E5 
7768 
6574 
6B20 
0364 
6B20 
03CD 



.zBACKUP 1184~ 

NOTICE 

(c) 1983 

Cosmopolitan 

Electronics 

Corporation. 

NOTICE 

************, . ,4 

DBL DENSITY » m. 
SNG DENSITY - .. 
Press "ENTER" wh 
en the ..Complet 
ed.. source disk 
is in drive 0. .d 
estination disk 
is in drive 0... 



) 



Here are several byte patterns with the sensitivity indicated. : . 

least sensitive 

mildly sensitive (IBM single density) 
mildly sensitive (equivalent to E5 E5) 
intermediate (TRSDOS ( tm) MODEL III) 
most sensitive (MULTIDOS) 

The more sensitive the byte pattern, the greater the probability a marginal 
diskette will fail format and the lesser the probability that having 
formatted successfully, the diskette will fail later. The less sensitive 
the byte pattern, the lesser the probability a marginal diskette will fail 
format and the greater the probability that having formatted successfully, 
the diskette will fail later. 



00 00 


= 


E5 E5 


= 


6C 6C 


= 


5B 5B 


- 


6D B6 


= 



J 



J 



J 



) 



CAT/CMD . Display a directory of a TRS-80 ( tm) disk. 

CAT[mask][ [ [ : ]d] (A] [ ,1] [ ,11] [ ,R] [ ,S] ) ]<ENTER> 

A » disk map of files 

I = display invisible files 

M = wait for "alien" disk mount in logical drive 

S = display system files _ -, 

CAT/CMD will display the directory on practically anyTRS-80 (tm) disk, 
including MODEL I, MODEL III, MODEL 4 , and MAX-80 disks, regardless of the 
address marks, density, or sector/granule format. See library command DIR 
for the explanation of "mask". 
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CDIR *' Zero unused directory entries. 

CDIR[ [:]d]<ENTER> 

CDIR will zero unassigned directory entries. When a file is KILLed, 
MULTIDOS simply resets a bit to indicate the directory entry is available. 
The library command RESTOR, sLraply sets this bit. CDIR will completely zero 
the entire 32 bytes of the directory entry, thus preventing any recovery of 
a KILLed file. 



CONVERT/CMD Change address marks on single density disks, (not MODEL I) 

CONVERT [ [:]d]<ENTER> 

CONVERT will change the USER DEFINED address marks on an single density 
diskette's directory sectors to DELETED address marks. CONVERT is required 
for the MODEL III, MODEL 4, and MAX-80 versions of MULTIDOS to read certain 
single density diskettes. When you attempt to display the directory of a 
single density diskette and the error message is: 

Granule allocation table read error. 
Directory read error. 

the single density diskette probably needs the address marks converted. 

EXAMPLE: 

CONVERT :2<ENTER> 

This will change the address marks on the disk in drive 2. 

If no drive number or zero is specified, 

'Press "ENTER" when the target diskette is in drive zero.' 

will be displayed. Insert the single density diskette in drive zero, then 
press <ENTER>. After CONVERT is complete or an error occurs, you will be 
prompted to insert a MULTIDOS system disk. 



COPY/CMD Duplicate a single file. 

'_• COPY [//]filespecl:dl [to] [f ilespec: ]d2 

COPY [:]d [//]filespecl [to] filespec2 

COPY [: ]d [#]f ilespec 

COPY $ [//]filespec:dl [to] [f ilespec: ]d2 (dl or d2 - 0) 

COPY $[:]0 [//]filespecl [to] filespec2 

COPY $[:]0 [//]f ilespec 

COPY/CMD will duplicate a file from one disk to another. 
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SYSTEM UTILITIES 

The disk containing the file will be referred to as the source disk. The 
disk to receive the file will be referred to as the destination disk. 
If the- filespec for the destination disk is the same as the filespec for 
the source disk, then the fiLespec need not be repeated. 

COPY CHARGES/TXT: I to :2<ENTER> 

If the destination disk drivespec is the same as the source disk drivespec, 
COPY/CMD will prompt you when to mount the source or destination disk. 

COPY :3 SHIFT/TXT to MURK/ABC<ENTER> 
COPY SHIFT/TXT: 3 to MURK/ABC: 3<ENTER> 

Both of the above two commands wilL duplicate the contents of SHIFT/TXT to 
MURK/ ABC in logical drive number three. 

Whenever logical drive zero is a drivespec, and the source OR destination 
disk is not a system disk, a "$" MUST precede the source filespec. A 
MULTIDOS system disk is a disks with at least, Allocate/DOL, Command/DOL, 
Open/DOL, Close/DOL, and Error/DOL. 

COPY $WHENEVER/BAS:0 to :2 
. COPY :0 $HELPME/CIM to SHOWME/CIM 
"• COPY $ THEM/OLD :0 to THEM/NEW: 1 
COPY $ MANUAL/TXT: 3 

Please follow the prompting provided by COPY/CMD. Whenever the prompt: 

'Insert SYSTEM <ENTER>' 

is displayed, remove the source or destination disk from logical drive 0, 
insert a MULTIDOS system disk into logical drive 0, then press <ENTER>. 

COPY normally assigns the source filespec's date to the destination, file. 
However, if the destination file Is to receive the date stored in RAM, 
place a "//" immediately in front of the source filespec. 

COPY //CHECKING/BAS :1 to CHECKING/BAS : 2 

COPY //CHECKING/BAS :0 to :0 

COPY :2 //CHECKING/BAS 

COPY 2 //CHECKING/BAS to CHECKING/BAS 

COPY :0 $ //CHECKING/BAS 

COPY/CMD will not prompt you to mount a disk when the source and 
destination drivespecs are different, and neither is logical drive 0. 

_" COPY FUNL0VER/TXT:2 to : 3 

Does NOT prompt the user to mount any disks. 

The colon, ":", is optional for stand alone drivespecs. 

COPY FILEDOS:! to 2 
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DBLFIX/CMD Fix boot sector on DBLDOS (tin) diskettes. 

DBLFIX (:]d* 

DBLFIX/CMD will modify DBLDOS (tin) data and system diskettes to be read and 
written to by MULTIDOS. The DBLDOS ( tm) will perform the same after 
DBLFIX/CMD has modified the DBLDOS (tm) diskette. The diskette to be 
modified must not be write protected. 

DBLFIX/CMD requires at least two drives. The drive number specified, "d", 
must be other than zero. 

EXAMPLE: To fix a DBLDOS (tm) diskette in drive 1. 

DBLFIX :1 



DDT/CMD Disk drive timer. 

DDT<ENTER> 

DDT/CMD is a diskette drive rotation speed timer, requiring a diskette, 
formatted or un-formatted, to be in the selected disk drive. 

NOTE: The MODEL I version of DDT/CMD executes an OUT 254,0, and the 
MODEL III version executes an OUT 95,0 to reset any high speed 
modification. Hardwired highspeed modifications must be reset to the normal 
CPU speed for DDT/CMD to indicate the correct rotation speed. 



FMAP/CMD Allocation map. 

FMAP[ [:]d][ P][D]<ENTER> 

d = logical drive 

P = send to printer 

D = double space (used with P) 

FMAP/CMD will display and/or print a map of allocated granules, directory 
granules, and any flawed granules. 

EXAMPLE: . 

FMAP 1 PD<ENTER> 

This will printout an allocation map of the disk in logical drive one, and 
double space each line. FMAP uses these symbols to indicate how a disk is 
allocated. 

. = unassigned granule 

X = assigned granule 

D = directory granule 

L = locked out granule 

■» 
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SYSTEM UTILITIES 

FORMAT/CMD Prepare a .-lisle for data storage. 

-FORMAT[ [:]d] [ AJ [ ! ] [ -diskname]<ENTER> 

d - drive number 

A = absolute format 

! = use current DCT parameter values, 

and the default track count 
- = to signify a disk name to follow 

FORMAT/CMD will prepare a disk for file storage only. 

FORMAT/CMD will take you through the easy procedure to format a disk. 
After FORMAT/CMD is loaded and executes, the screen will clear and 

'MULTIDOS Formatter Program - Version X.X 

Which drive contains the diskette to be formatted? __' 

will be displayed. Reply with the target diskette's logical drive number. 
If the drive number was specified in the FORMAT command line, then this 
query will be bypassed. 

.'Name of diskette to be formatted (default "* DATA *")? __' 

Reply with the desired disk name 1 to 8 characters in length, or press 
<ENTER> if "* DATA *" is acceptable. 

(Q3) 'Track count for this diskette ( 2 to 96 - default 40)? _' 

Reply with the desired track count. FORMAT can only format up to the drive 
capacity. If you only have a 40 track drive, you cannot format 80 tracks. 

'Date for diskette to be formatted (default mm/dd/yy)? ___' 

Reply with a date in the format mm/dd/yy, or press <ENTER> to use the 
default date. 

'Master password for this diskette (default PASSWORD)? __' 

Reply with the password 1 to 8 characters in length, or press <ENTER> to 
use "PASSWORD". 

'Single, Double, or "P" density ( S,D, or P - default "x")? __' 

Reply with S, D, or P, as desired, or press <ENTER> to use "x". 

'Which track for the DIRECTORY ( 1 to XX - default 17)? __' 

XX = One less than the track count entered in (Q3). Press <ENTER> to use 
17, or enter the desired directory track. 



) 
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If the disk to be formatted contains data, and the "A" option was not 
specified in the FORMAT command line, then the message: 

'Disk contains data. 

The disk name is DISKNAME, dated mm/dd/yy. 
Re-format this diskette (Y/N/Q)? _' 

will appear. If you want to reformat this disk, press <ENTER> or input a 
<Y>. A <N>, <Q>, or <BREAK> response will to abort FORMAT. • 

The format pattern placed on the disks by FORMAT/CMD may be changed by 
zapping one to four bytes on FORMAT/CMD's first sector. Key in ZAP<ENTER>, 
press <F>. Enter FORMAT/CMD to the Filespec prompt. When ZAP/CMD requests 
"Relative sector in file FORMAT/CMD ( to 0014/00EH )....", press <ENTER>. 
Relative sector number zero of FORMAT/CMD will be displayed at this point. 
The format pattern bytes for double density are located in bytes 8EH/8FH, 
and for single density In bytes 9EH/9FH. The default format track value, 
hexadecimal, is located in byte AFH. 









Relative sector zero ol 


E FORMAT/CMD 


F HEXOO 


057A 


464F 


524D 


4154 


2020 


2031 


3138 


347E 


.zFORMAT 1184" 





10 


2A20 


2020 


204E 


4F54 


4943 


4520 


2020 


202A 


* NOTICE * 


R DR 


20 


2A20 


2028 


6329 


2020 


2031 


3938 


3420 


202A 


* (c) 1984 * 


M 


30 


2A20 


436F 


736D 


6F70 


6F6C 


6974 


616E 


202A 


* Cosmopolitan * 


A 


40 


2A20 


2045 


6C65 


6374 


726F 


6E69 


6373 


202A 


* Electronics * 


T TR 


50 


2A20 


436F 


7270 


6F72 


6174 


696F 


6E2E 


202A 


* Corporation. * 


/ 02 


60 


2A20 


2020 


204E 


4F54 


4943 


4520 


2020 


202A 


* NOTICE * 


C 02 


70 


2A2A 


2A2A 


/* PlZ. Pi. 


2A2A 


2A2A 


2A2A 


0102 


0034 


************ # # % 4 


M 


80 


4442 


4C20 


4445 


4E53 


4954 


5920 


3D20 


6DB6 


DBL DENSITY = m. 


D SE 


90 


534E 


4720 


4445 


4E53 


4954 


5920 


3D20 


E5E5 


SNG DENSITY = .. 


00 


A0 


4446 


4C54 


2046 


4D54 


2054 


524B 


203D 


2028 


DFLT FMT TRK = ( 


00 


B0 


3E80 


CD64 


3918 


1C3E 


OOCD 


9644 


3AEC 


370F 


>..d9..>.. .D: .7. 




CO 


30FA 


FDCB 


0056 


280B 


3E00 


CD96 


443A 


EC37 


0....V(.>...D:.7 


FILE 


DO 


0F30 


jf x\J>x\ 


303A 


CD8A 


3922 


B136 


219F 


36CD 


.0.:0:..9 M .6!.6. 


0000 


E0 


6744 


1600 


CD1D 


3A0E 


OOCD 


0039 


C27B 


36FD 


gD. ,,.:,. . .9. {6, 


000H 


F0 


CB02 


7E28 


1432 


4439 


3A63 


3457 


C5CD 


1D3A 


,.~(.2D9:c4W...: 



00 00 = least sensitive 

E5 E5 = mildly sensitive (IBM single density) 



6C 6C 



mildly sensitive (equivalent to E5 E5) 



5B 5B =» intermediate (TRSDOS ( tm) MODEL III) 

6D B6 = most sensitive (MULTIDOS) 

*The more sensitive the byte pattern, the greater the probability a marginal 
diskette will fail format and the lesser the probability that having 
formatted successfully, the diskette will fail later. The less sensitive 
the byte pattern, the lesser the probability a marginal diskette will fail 
format and the greater the probability that having formatted successfully, 
the diskette will fail later. 
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GR/CMD Configure keyboard for graphics. (MODEL l/III only) 

^GR<ENTER> 

GR/CMD will modify the keyboard to produce graphic characters directly from 
the keyboard. GR/CMD loads into high memory and resets the TOPMEM address. 
To produce keyboard graphics press <SHIFTXCLEAR>. To return to normal 
keyboard characters press <SHIFTXCLEAR> again. 



Keyboard graphic character set 
(pixels lit) 

= - 1 = ■ 2 = - 3 = ■ 4 = 1 5 = W 6 = P 

B *= - C ■ fc D-J 

I = r J = I K = | 

p«ji Q « y R"r 

w = r. x = ; y - - 



7 


* . 


■ 


8 *= % 


9 


IS | 


A ■= "■ 


E 


= 


■ 


F = . 


G 




H = / 


L 


- 


jT 


M -T 


N 


*= m m 


« > 


S 


= 


b 


T - + 


U 


= P 


v = . 


z 


B= 


W 


up-arrow 


ss 


■. 





lowercase (or SHIFTED without lowercase keyboard) 

a = .£ D = ^ c«=| d « "i e*=| 

h = H i = «f J = * »< = « 1=1 

o = i. p *= L q = i r = c b«ji 

v = a w = H x=h y = d z = H 



f 


«= 


T 


g 


* "1 


m 


= 


■ 


n 


cs *• 


t 


«= 


i 


u 


- J 



HELP/CMD (see HELP under LIBRARY COMMANDS) 
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LO/CMD Executable object file offset. 

L0[ filespec]<ENTER> 

LO/CMD will change where a file loads or put a Linage of the loaded file in 
a filespec or place the image on disk sectors. LO/CMD does not require a 
"/CMD" extension. However, if you want to access a file without an 
extension, place a "/" after the filename. Lets do this one together. 

j 

LO LO<ENTER> 

The screen clears and 

'Load Offsetter - Version 1.0 (c) CE.C. 1984. 
•. Source Filespec? LO 

Relative or fixed offset (R/F)? _' 

is displayed. Press <ENTER> (default = the first choice, "R" - relative). 

'Program loads: 
5200 - 522C 
5300 - 5AFB 
Entry point = 5200 
Offset appendage (Y/N)? __' 

Is displayed. The information on the display tells us that the file LO/CMD 
loads from 5200H to 522CH, skips over 522DH thru 52FFH, loads 5300H to 
5AFBH, and has an entry point of 5200H. A <Y> or <ENTER> response will tell 
LO/CMD to add an offset appendage to a file we would specify later. The 
offset appendage will move the file to 5200H before the file executes. 
Respond <ENTER> (default "Y"). If we had entered an N, we would bypass this 
query. 

'Disabled or enabled interrupts (D/E)? __' 

will be displayed. Press <ENTER> (default = first choice, "D" disabled). 
Then 

'New base address in HEX? __' 

is displayed. An <ENTER> here will default to the lowest load address 
displayed (5200H). Key in 7000<ENTER>. Now 

'Destination filespec? _ 

is displayed. Here is where we enter the filename (auto "/CMD" appended). 
Instead we will start over by entering an "*" character to this query. The 
"*" character will start us at the "Source Filespec? __" prompt, if entered 
to "Offset appendage (Y/N)? _" or queries to follow. Key in L0<ENTER>. Now, 
lets respond F<ENTER>. 

'Load base starting address HEX (5B00 minimum)? _' 

is displayed. Press <ENTER> (default = 5B00II). 
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SYSTEM UTILITIES 

'Program loads: 
5200 - 522C 
* 5300 - 5AFB 

Entry point = 5200 

Load marks or direct dump (L/D)? _' 

is displayed. Press <ENTER> (default = the first choice, "L" - load marks). 
Uttset appendage (Y/N)? _" appears again. Key <ENTER> and key <ENTER> to 
the next query also. Now 

'Entry point HEX? _' 

is displayed. An <ENTER> here will default to the appendage entry point, 
any other address will be taken verbatim. Key in 402D<ENTER>. The file we 
could name would load then exit to MULTIDOS. Lets go back to the begining 
once more. Enter <*>. Key in L0<ENTER>. Respond F<ENT-t>, <ENTER>. Now 
D<ENTER> for the "Load marks or direct dump (L/D)? _" query. 

'File or disk sectord (F/D)? _' 

appears on the display. An <F> or <ENTER> response will take us to the 
Destination filespec? _" prompt, but a <DXENTER> will ask us for drive, 
track and sector. A direct dump fLle has no load marks. All of the BCOT/SYS 
files on the other operating systems are direct dumped files. LO/CMD is a 
complex utility, but it is also powerful. SYSRES/SYS on your MULTIDOS 
A diskette was created with this utLlity. Applications unlimited! 

MEM/CMD Random Access Memory test. 

(1)MEM<ENTER> (MODEL I /HI) 

(2)MEM[ B]<ENTER> (MAX-80/M0DEL A) 

(1) MEM/CMD will test random access memory from 4000H to TOPMEM. 

(2) MEM/CMD will test random access memory from to TOPMEM. If "B" is 
specified, then the 64K of expansion RAM is distruct ively tested. 

If a memory bit fails, the byte and bit that failed will be displayed. 

MEMDISK/CMD Random access psuedo drive. 

(1)MEMDT.SK[ t]<ENTER> (MODEL I/ill) 

t = number of tracks (2 to 16) 
(2)MEMDISK[ [:]d]<ENTER> (MAX- 80 /MODEL 4) 
d = drive number (0 to 7) 
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iilnrf^n 7 mV 111 let y °" USe part of hi - h metnor y as a data disk. 
MEMDISK/CMD will consume 2K of RAM for each track, "t", specified. If you 
do not specify a track count, MEM DISK/CMD will default to L6 tracks (32K) . 

EXAMPLE: 

MEM DISK 8<ENTER> 

3^nTcv eate ?i a ^EMDISKwith 8 tracks (16K). The logical drive assigned to 

hi i j. W1 the first availab le logical slot in the DCT. MEMDISK/CMD 

will adjust TOPMEM to protect itself. However, if you use an application 

S^nT 31 ? Whl S h d ° eS n0t rec °S nize TOPMEM, you may clobber the MEM DISK. 
ilEMDISk can be used as you would use any other drive, but remember MEM DISK 
does not maintain data if the power is removed or the computer is reset. 

(2) MEMDISK/CMD will use the 64K of expansion RAM as a data or system disk. 
If drive zero or no drive number is specified, then MEMDISK/CMD will copy 
all of the necessary system overlays to MEMDISK, creating a system MEMDISK. 

To remove a MEMDISK, key: 
MEMDISK X<ENTER> 

MEMDISK/CMD will remove MEMDISK from the DCT, then restore TOPMEM if TOPMEM 
wasn t changed after MEMDISK is loaded. If MEMDISK was a system disk, then 
MEMDISK/CMD will prompt you to insert a system disk into the prior logical 
drive 0, containing the system disk which loaded MEMDISK. 



PRT/CMD Forms filter. 

(1) PRT<ENTEB> (MODEL I/III) 

(2) PRT bl[,b2][,b3][...blO]<ENTER> (MAX-80/MODEL A) 

(1) PRT/CMD is a high memory, . menu driven forms filter and graphic 
character converter for the MODEL I and MODEL III. PRT/CMD is required to 
enable the library command FORMS. After PRT<ENTSR> is executed, the prompt: 

'Enter decimal code to be ignored. _' 

will be displayed. Enter the decimal numbers (1 to 255), one at a time - 
for up to ten numbers, you do no:, want to go to the printer. If you do not 
want to filter any values, or have only entered a few, respond with lust 
<ENTER> to the prompt, then " * J 

'Graphic conversion for EPSON printer (Y/N)? _' 

Enter <Y> If you have an E^SON printer capable of printing the TRS-80 (tin) 
video graphic characters, otherwise enter <N>. 

(2) PRT/CMD is a high memory sequential filter for the MAX-80 and MODEL 4. 
PRT/CMD will accept the first 10 values entered on the command line. If 
additional -alues are desired, re-issue the "PRT bl,bl,b2, etc." command 
until you ha\ a loaded all the desired values to filter. 
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i RS/CMD Machine Memory Scanner. 

- RS<ENTER> 

• w?*?r f^K^ mem °/ y f ^ ra J °? 00H to FFFFH and attempts to locate an 8 bit 

byte or 16 bit word specified by the user. The first query will be: 

'START? __' 

Enter the starting address, in 4 hex digits followed by <ENTER>, then 
'STOP? _' 

addre^ d }n P i a 2? d ^V h V}? ht °J, the startln 8 address. Enter the ending 
address, In 4 digit hex followed by <ENTER>. Next RS/CMD will ask: 

1 'Byte, or word search (B/W)? .' 

For a byte, search press <B>. For a word search, press <W>. Next RS/CMD 
. will ask you to enter the search target. Enter two (for byte search) or 

I four (for word search) hexadecimal characters. 

Next, for word scans only, the prompt: 

■ 'Enter auxiliary mnemonic _' 

1 y will be displayed. You can optionally inquire about calls, jumps, and loads 

| ' to a selected word at this time. Enter one or more of the following: 

C = call/carry 

J = jump 

I L = load 

M = sign minus 

i NC = non carry 

i NZ = non zero 

J P = sign positive 

PE = parity even 

PO = parity odd 

Z = zero 

I 

The above terras may be combined if needed. If no auxiliary mnemonic is 
desired press <ENTER>. For the "L" (LOAD) command, the following question 

J 'Immediate, or Direct (I/D) .' 

will be displayed. If the response is "D", then: 

J .- 'From, or to the register (F/T) .' 

{ will be displayed. Answer as desired. 

J 

i : 
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Next the query: 

'Accumulator -A or, register pair - BC , DE, HL, SP, IX, IY : ' 
will be displayed. Enter M A" or the desired register pair. 

RS/CMD will display the hexadecimal locations where the specified bvte or 
word is found. * J 

SPOOL/CMD Variable RAM printer buffer. (MODEL I/I'II) 

SPOOL<ENTER> 

SPOOL/CMD has two questions. 

'How many 256 byte BLOCKS for SPOOLING (1-99)? _' 

This lets you set the buffer size for the spooler. The size is selected in 
1/4 K increments. For example, to reserve a 2K buffer the reply to the 
above question would be 8<ENTER>. 

'Enter MEMORY SIZE (decimal) you want to protect. _' 

Use this to protect a high memory routine which does not protect itself bv 
setting TOPMEM. Press <ENTER> to use TOPMEM. 

The spooler will now commence operation and control of any printed output 
until <RIGHT-SHIFTXBREAK> is pressed. This will suspend "output and the 
query: 

'Buffer? _ 

will appear. Enter <Y> to save the buffer contents, or <N> to reset the 
pointers and send a carriage return character to the printer. 
The next query to appear will be: 

'SPOOL? _' 

Enter <Y> if you want to continue spooling, or <N> to remove SPOOL/CMD. 
when SPOOL/CMD is removed and nothing changed TOPMEM, the TOPMEM value 
previous to SPOOL/CMD loading will be restored. 
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TAPE/CMD Tape to disk caiwEar utility 

* TAPE<ENT!iR> 

TAPE/CMD will transfer a 500 bund contiguous system program from tape to 
disk. The utility will prompt: 

'ENTER "T" to read TAPE, or "D" to return to DOS? _' 

Ready the tape deck and position tape to start of file. Enter <T> to begin 
loading the system tape. If the file on tape does not load properly or is 
not contiguous, an error message will appear and the tape load will exit. 
If the file loads properly, indicated by START, END and ENTRY points of the 
program being displayed, it Is ready to be transferred to disk. The prompt: 

'Is the PROGRAM "xxxxxx" to be modified (Y or N)? _' 

will be displayed. This prompt wants to know if you want the program to 
load at another address, then shift to the START address. 



I If <Y> is entered, then 

'Are interrrupts to be enabled or disabled (E or D)? 



will be displayed. Enter <E> if the interrupts are to remain enabled, or 
enter <D> if the interrupts are to be disabled before the program executes. 

'Enter new base address in HEX? _' 

Enter a new base address greater than ACFFH, and GREATER than the programs 
start address, enabling MULTIDOS to load the program to a nonconf licting 
area with DOS. An offset appendage is added to the disk file to transfer 
the program to the START address. The next prompt: 

'Initialize LEVEL II type DCB and RST vectors (Y or N)? _' 

will be displayed. Respond <Y> if the program requires a LEVEL II 

environment, or <N> if the program does not require a LEVEL II environment. 

Whether the program is to be modified or not the following prompt will 
appear: 

'Is a new FILESPEC required (Y or N)? _' 

Enter <Y> if a new filespec is required, or <N> if the name of the file 
loaded from tape will be used and the extension /CMD will be appended to 
the filename. 

'Filename please? _' 

will appear if you choose to give the program a new filespec. 

Once all prompts are answered the program will be transferred to disk. 
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VFU/CMD Versatile file utility, 

VFU<ENTER> - 
VFU/CMD provides for five frequently needed disk operations: 

(1) copy a file(s) from one disk to another, 

(2) execute a file, 

(3) directory printout, 

(4) move a file(s) from one disk to another, and 

(5) purge a file(s). 

VFU/CMD will calculate the amount of free memory upon entry. If enough 
memory is available, VFU/CMD will load Open/DOL, Close/DOL, and 
Allocate/DOL into high memory, enabling the user to copy, move, or purge 
without a system disk in drive zero. If Insufficient memory is available, 
then the message: 

'Insufficient MEMORY for C/M/P 
without a SYSTEM disk in drive zero. 
Press any key to continue.' 

will appear, warning the user to keep a system disk in drive zero. 

VFU/CMD is ready for your command when: 

'Versatile File Utility - 8.x (c) C. E. C. 1984 

Press Action 

"C" Copy 

"E" Execute 

"H" Hard copy 

"M" Move 

"P" Purge 
Choice _' 

is displayed. Key in your choice. 

The <CLEAR> key will exit VFU, whenever the winking cursor is displayed. 

VFU - COPY COMMAND - <C> 

The copy command can be used to copy files from TRSDOS ( tin) Model III 
double density diskettes to a non-TRSDOS ( tm) disk. 

To copy files press <C>. VFU/CMD will respond with: 

'Condition (A/C/D/E/O/S)? _' 

This is a means to select the conditions to meet before file copying can 
take place. 
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SYSTEM UTILITIES 

A = any condition. 

C = create only. Only copy fLle(s) if the file(name) do not exist 

on the destination disk. Useful to avoid overwriting a file 

with the same name. 
D = different data. Only copy file(s) if the existing file(narae) on 

the destination disk has a different date. 
E = earlier date. Only copy file(s) if the existing file(narae) on 

the destination disk has an earlier date. Useful to avoid 

overwriting a later version of the same file(name). 
= overwrite. Only copy file(s) if the file(naine) already exist on 

the destination disk. 
S = size difference. Only copy file(s) if the file(s) on the 

destination disk ar<* different In file size, (different EOF) 

The next prompt will be: 

Press "S" for selective, or "T" for total. 

To select the files to be copied, press <S>. To copy all files, press <T>. 
The next prompt will be: 

'Include "INVISIBLE" fil.es? _' 

Press <N> or <Y> as appropriate. 

'Include "SYSTEM" files? _' 

Press <N> or <Y> as appropriate. Finally, VFU/CMD will request the source 
and destination drives with the following prompt: 

'Source drive? _ Destination drive? 

The source and destination drive cannot be the same. Press the number for 
the logical source drive, then press the number for the logical destination 
drive. 

Press <BREAK> at any of the above prompts to return to the "Choice" prompt. 

If the selective option was chosen, the directory will be displayed with 
the winking cursor next to the first filspec name. The arrow keys will move 
the winking cursor in the arrow direction. If you want to copy that file 
press <Y>. A "+" symbol will appear in front of the filename (file marked) 
indicating this file is to be copied, and the winking cursor will move to 
the next file. If you do not want to copy a file, press <N>, or the 
<SPACE-BAR>, and the cursor will move to the next file. During the file 
selection process, the shift left arrow will reposition the cursor to the 
first filename removing all "+" symbols. To remove a "+" symbol from a 
single file, use the arrow keys to position the cursor over the "+" symbol 
and press <N> or <SPACE-BAR>. If you move beyond the last file, you can 
press the left arrow key to continue file selection. If the total option 
was selected, the directory will be displayed with a "+" symbol in front of 
every filename. Use the left arrow to "un-mark" files,- or the shift left 
arrow to "mark" all files. 
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After all selected files have been marked for copying, press <ENTER> to go 
to the prompt: 

'Press "A" to abort, "ENTER" to execute, or "R" to repeat. _' 

Press <ENTER> to start the copy function. To terminate the copy function, 
before all files are copied, hold down a shift key until VFU/CMD completes 
copying the current file. 

After the copy process is complete, the directory of the destination disk 
will be displayed, indicating this command is complete. 

VFU - EXECUTE COMMAND - <E> 

Use the arrow keys to position the winking cursor in front of the file to 
be executed, then press <Y>. The EXECUTE command will immediately run the 
program when the <Y> is pressed. If' the selected filespec does not have a 
"/CMD" extension, the EXECUTE command will load BASIC and attempt to run 
the filespec. 

VFU - PRINT DIRECTORY COMMAND - <H> 

To print a directory, press <H>. The next prompt will be: 

'Include "INVISIBLE" files? _' 
Press <N> or <Y> as appropriate. 

'Include "SYSTEM" files? _' 

Press <N> or <Y> as appropriate. Finally, VFU/CMD will request the drive 
with the following prompt: 

'Drive number? _' 
Press <BREAK> at any of the above prompts to return to the "Choice" prompt. 
After the logical drive number is pressed, the prompt: 

'Identification: 

is displayed. Input your choice (8 characters maximum) to identify this 
disk. After you press <ENTER>, the directory will be displayed on the 
screen. Finally, the utility will prompt with the following message: 

: 'Press "A" to abort, "ENTER'* to execute, or "R" to repeat. __' 

A reply of <ENTER> will cause the directory to be printed. If a 10 
character per inch printer is used, the printout width will be sized to fit 
Inside a 5 1/4" diskette jacket. 

VFU - MOVE COMMAND - <M> 

The MOVE command performs the same as the COPY command except the file on 
the source drive will be purged after each file is copied to the 
destination drive. 

Page 62 



SYSTEM UTILITIES 

~ VFU - PURGE COMMAND - <P> 

To purge files from a disk, ores* <P>. The next prompt will be: 
'Press "S" for selective, or "T" for total. _' 

To select the files to be purged, press <S>. To purge all files, press <T>. 
The next prompt will be: 

'Include "INVISIBLE" files? _' 

- Press <N> or <Y> as appropriate. 

'Include "SYSTEM" filas? _' 

Press <N> or <Y> as appropriate. Finally, VFU/CMD will request the drive 
with the following prompt: 

'Drive number? __' 

Press the desired logical drive for file purging. 

Press <BREAK> at any of the above prompts to return to the "Choice" prompt. 

If the selective option was chosen, the directory will be displayed with 

the winking cursor next to the first file name. The arrow keys will move 

\ he waking cursor in the respective direction. If you want to purge 

J file press <Y>. A "+" symbol will appear In front of the filename (file 

^ .arked indicating this file is to be purged, and the winking cursor will 

move to the next file. If you do not want to purge a file, press <N>, or 

the <SPACE-BAR>, and the cursor will move to the next file. During the t l le 

selection process, the shift left arrow will reposition the cursor to the 

first filename removing all "+" symbols. To remove a + ^symbol from a 

file, use the arrow keys to position the cursor over the + symbol ana 

press <N> or <SPACE-BAR>. If you move beyond the last file, you can press 

the left arrow key to continue file selection. If the total option was 

■ selected, the directory will be displayed with a + symbol Inf ron f 

every filename. Use the left arrow to "un-mark files, or shift lett arrow 

to "mark" all files. 

After all the selected files have been marked for purging, press <ENTER> to 
go to the prompt: 

'Press "A" to abort, "ENTER" to execute, or "R" to repeat. __' 

Press <ENTER> to start the purge function. To terminate purging, before all 
files are purged, hold down a shift key until VFU/CMD completes purging the 
current file. 

After the purge process is completed, the revised directory of the disk 
will be displayed, indicating this command is complete. 
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ZAP/CMD Disk sector/memory mod If teat: ion utility. 

ZAP<ENTER> 

ZAP/CMD is a quick, simple way to copy disk sectors, tread and modify disk 
sectors, read and modify fiLe sectors, r-^ad and modify RAM, format t single 
track, verify sectors, and fix MULTIDOS directories. 

General ZAP/CMD information. 



A. DEFAULTS 

When ZAP/CMD is waiting for a variable response, ZAP/CMD will default to 
the first choice or lowest value if <ENTKR> is pressed. Whenever an 
input field is complete, ZAP/CMD will automatically insert an <ENTER> 
for you. i.e. if the query is "DENSITY (S/D) ." (one character input 
required), pressing <ENTER> or <S> will terminate the query an continue. 

B. NUMBERS 

Numbers are interpreted as decimal, unless an "H" is appended to the 
number. If a number is suffixed with an "H" , then the number is 
considered hexadecimal. 

C. BREAK KEY ,j 
Pressing <BREAK> will return the user to the previous query. When the '* 
"Choice" prompt is displayed, pressing <BREAK> will exit ZAP/CMD. 

D. MODIFICATION x 
Pressing <M> after a displaying a page of MEMORY or a diskette 3ECT0R,\l 
will place the user in the modification mode. This is noted by two" 
transparent blinking cursors - one in the HEX area and the other in the 

" corresponding ASCII area (right 16 bytes). The arrow keys will move both 
cursors in the arrow direction. The "@" key will toggle the user between 
the HEX and ASCII modification mode, as indicated by the presence of 

:. ' "HEX" or "ASC" in the upper left hand corner for sector displays. Key in 
the new data for the bytes to be changed. Two keystrokes are required 

,'""'.' for hexadecimal changes, or one keystroke for ASCII changes. Memory 
modification is effective immediately. However, sector modification is 
not effective until <ENTER> is pressed to terminate modification and 
<ENTER> is pressed a second time to update the sector. 

Copy sectors <C> 

The "Copy sectors" option is obtained by pressing <C>. This option will 
copy sectors from any disk MULTIDOS will read to any other disk MULTIDOS 
will read. However, the user is cautioned to make sure the configuration 
byte for the source and destination disks have be set properly. These bytes 
are set correctly after a successful "DIR", or "File sectors" to BOTH 
disks. This option is menu driven, and won't overwrite some of the data if 
the same disk is used for the source and destination (in the same -drive). 
"Copy sectors" cannot copy sectors between two different disks to be 
mounted in the same drive. 
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Disk sectors <D> 

The "Disk sectors" option is obtained by pressing <D>. This option will 
step through a single density, double density, or "P" density diskette, 
provided the target diskette has had Lts respective configuration byte 
updated (this byte Ls correct aCter a successful "DIR", or "File sectors"). 
TRSDOS (tm) double density diskettes (MODEL £11 - versions 1.1, 1.2, and 
1.3; MODEL I - version 2,7 and 2.8) do not have a configuration in 
MULTIDOS, therefore; they are not supported. Use of this function requires 
user discipline In selecting the track number. ZAP unihlbitedly accepts 
track and sector numbers from to 255. The selection of the first sector 
is menu driven, and additional sectors are displayed by pressing: 



Key pressed 

UP ARROW 
DOWN ARROW 
RIGHT ARROW 
<SHIFT> RIGHT ARROW 
LEFT ARROW 
<SHIFT> LEFT ARROW 
"T" 
"S" 



Action 

Increase track count by one 
Decrease track count by one 
Increase sector by one 
Increase sector by one 
Decrease sector by one 
Decrease sector by one 
Reselect track/sector 
Reselect sector 



.) 



File sectors <F> 

The primary function of the "File sectors" option is to access files, 
regardless of protection, regardless of density, regardless of the 
operating system {except TRSDOS ( tm) MODEL I double density}. 

The "File sectors" option is obtained by pressing <F>. This option requires 
the filename to be entered exactly as the file name appears In the 
directory (every character and character case significant). Although ZAP 
will search all drives for a given filespec, It is suggested that the drive 
number be appended to the filename, i.e. FILENAME/EXT: D. This will greatly 
decrease the access time, because ZAP performs an analysis on each diskette 
prior to the HIT search for the filespec's hash code. 

Enter the target file name at the 



'Filespec 



prompt. 



) 
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If ZAP/CMD finds the file, then 

'Relative sector in xxxxxxxx/xxxu ( to dddd/hhhH) . ...' 

will be displayed. The M xxxxxxxx/xxx:x" will, be replaced with the target 
file name, and dddd/hhhH will be the Ust relative sector in the target 
filename in decimal (dddd), and hexa.loei.-nal (hhhH). Enter the dnsired 
/?K,^os 6 s^tor. (A file's first sector is relative sector zero [0]). 
<ENTLR> will display the first sector of the file, and a number greater 
than dddd/hhhH will display the dddd/hhhH relative sector. Additional 
sectors in the target file can be accessed by use of the arrow keys. 



Key pressed 

UP ARROW 
DOWN ARROW 

[<SHIFT>] RIGHT ARROW 
[<SHIFT>] LEFT ARROW 



Action 

Increase file sector by one 
Decrease file sector by one 
Increase file sector by one 
Decrease file sector by one 



Memory <M> 



The Memory option is obtained by pressing <M>. when the "Address " 

prompt appears, enter the desired address. The memory address is changed by 
pressing the arrow keys. ° 



Key pressed 

UP ARROW 
DOWN ARROW 
RIGHT ARROW 
<SHIFT> RIGHT ARROW 
LEFT ARROW 
<SHIFT> LEFT ARROW 



Action 

Increase address by 256/100H 
Decrease address by 256/100H 
Increase address by one 
Increase address by 16/10H 
Decrease address by one 
Decrease address by 16/10H 



Track format <T> 

The "Track format" option is obtained by pressing <T>. This option will 
format and verify a single track on a floppy diskette. Don't be quick on 
the draw. The format density requires only one keystroke! 



Verify <V> 

The "Verify" option is obtained by pressing <V>. This option will verify 
that the target tracks - sector detailed - a readable. If the target 
diskette has mixed density tracks, "Verify" will switch density and keep 
getting up. Verify uses "logical tracks" when verifying a double density 
or double sided NEWDOS/80 ( tin) diskette. nensity 
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Fix directory <X> 

The "Fix directory" option U obtained by pressing <X>. This option is 
designed to fix the directories for MULTIDOS - version 1.7 diskettes. 
"Fix directory" will also fix tin*, directory for "alien" diskettes; however, 
the data placed on the GAT sector may not be compatible with the "alien" 
diskette's operating system. If you fix the directory for an "alien" 
diskette, be sure you have the accessary information to modify the data on 
the GAT sector - if "Fix directory" changes the GAT. The following 
information supplements the "Fix directory" option. 

The directory, usually fiLenaned D1R/SYS, has information which details the 

disks usage, filenames, location, length, protection level, logical record 

length, and password hash values for all files on the disk. Each directory 

has three separate but intergral sections referred to as tables: 

1. The Granule Allocation Table (GAT) has the data on free and allocated 
space on the disk. 

2. The Hash Index Table (HIT) has the hash codes for each active file on 
the disk. 

3. The balance of the directory sectors contain the directory records 
(DIREC) for each file. Each directory record is 32 bytes in length. The 
number of directory records varies with the density and number of sides for 
each disk. 

GAT Organization 

The granule allocation table is located on the first sector of the 
directory, containing information on disk space assignment. Disk space 
assignment is performed in a unit called a granule. - A granule is a 
subdivision of a LOGICAL track which consists of a contiguous group of 
whole sectors. A PHYSICAL trick is a one of many concentric circular 
recording surfaces on a side of a diskette or a platter in a rigid drive. A 
cylinder is the head position for all identical numbered tracks In a given 
drive. A cylinder may have one track for single sided floppy diskettes, 
eight tracks for a four platter rigid disk, six tracks for a three platter 
rigid disk, two tracks for a double sided floppy diskette, etc. The number 
of tracks for a cylinder will vary with the hardware configuration of the 
disk drive. However, the number of granules per LOGICAL track will be fixed 
in accordance to the table below. 

Granules/Track Granules/Cylinder Sectors/Granule 

2 5 
4 5 

3 6 
6 6 

2 8 

4 8 

3 10 
6 10 

SD=single density, DD=double density, SS=single sided, DS=double sided 

TABLE 1 
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Diskette 


Granule 


5 


1 SD/SS 


2 


5 


' SD/DS 


-2 


5 


' DD/SS 


3 


5 


' DD/DS 


3 


8 


* SD/SS 


2 


8 


' SD/DS 


2 


8 


' DD/SS 


3 


8 


' DD/DS 


3 
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The GAT is further divided into two additional tables, ftytes X'OO' through 
X'5F' are the assignment/ free table, which corresponds to an individual 
cylinder on the ^disk. Each bit within r.he byte Ls used to indicate which 
relative granules within the cylinder is assigned or freu. A reset bit 
indicates a free granule, and a set bit indicates an assigned granule. 

Refer to the GAT table in figure 1. 

Relative byte X'OC has the valae X'FU' (111U011). The bits set are 
7,6,5,4,3,1,0. Therefore, granule 2 is free. 

Relative byte X'lE' has the valje X'FA' (UlllOlO). The bits set are 
7,6,5,4,3,1. Therefore, granules 2 and aro free. 

Bytes X'60' through X'BF' are the available/locked out table, which 
corresponds to a relative cylinder. The available/locked out table 
indicates which granules are locked out during formatting. A reset bit 
indicates an available granule, and a set bit indicates a locked out 
granule. All granules locked out during formatting are also assigned in the 
assignment/free table. 

Byte X'CC contains the number of logical cylinders, and byte X'CD' 
contains the number of physical cylinders for the disk. (MULTIDOS only!) 

Bytes X'CE' and X'CF' contain the disk's master password hash code. 

Bytes X'D8' through X'D7' contain the disk name, and bytes X'D8' through 
X'DF' contain the disk date. 

Bytes X'EO' through X'FE' stores a system's disk "AUTO" command, if any. IF 
byte X'EO' is X'OD' , then there is no "AUTO" command. 



HEX 


00 
10 
20 
30 
40 
50 
60 
75 
80 
90 
A0 
B0 
CO 
DO 
E0 
F0 


FFFF 
FFFF 
F8F8 
FFFF 
FFFF 
FFFF 
F8F8 
F8F8 
F8F8 
FFFF 
FFFF 
FFFF 
FFFF 
4D55 
0D20 
2020 


FFFF 
FFFF 
F8FF 
FFFF 
FFFF 
FFFF 
F8F8 
F8F8 
F8FF 
FFFF 
FFFF 
FFFF 
FFFF 
4C54 
2020 
2020 


FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
F8F8 
F8F8 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
4944 
2020 
2020 


FFF8 
FFF8 
FFFF 
FFFF 
FFFF 
FFFF 
F8F8 
F8F8 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
4F53 
2020 
2020 


F8FF FFFF 
F8F8 F8F8 
FFFF FFFF 
FFFF FFFF 
FFFF FFFF 
FFFF FFFF 
F8F8 F8F8 
F8F8 F8F8 
FFFF FFFF 
FFFF' FFFF 
FFFF FFFF 
FFFF FFFF 
FFFF FFFF 
3132 2F30 
2020 2020 
2020 2020 

Figure 1 


FBFF 
F8F8 
FFFF 
FFFF 
FFFF 
FFFF 
F8F8 
F8F8 
FFFF 
FFFF 
FFFF 
FFFF 
2323 
312F 
2020 
2020 


FFFF 
FAF8 
FFFF 
FFFF 
FFFF 
FFFF 
F8F8 
F8F8 
FFFF 
FFFF 
FFFF 
FFFF 
E042 
3834 
2020 
2020 
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HIT Organization 

The Hash Index Table (HIT) is found on the second sector of the directory. 
The HIT is used to store, in a position which corresponds to the DIREC, the 
hash code for each active fiLe in the directory. The hash code is computed 
by creating an 11 byte work space, eight for the filename (left justified 
and padded with spaces) and three for the extention (left justified and 
padded with spaces). Thi3 work space is processed through a hashing routine 
which produces a one byte value of X'Ol' through X'FF'. The HIT reduces the 
time required to access a file, through the operating system, by 
eliminitlng the need to check byte for byte each filename in the directory. 
After the system matches the hash code, the corresponding DIREC is examined 
tor a byte for byte match of the f llename/ext. 



DIREC Organization 

The third through the last directory sector contain eisht 32 byte directory 

records (DIREC). The maximum number of directory records is 256, regardless 

of the number of sectors alocated to the directory. ^The HIT storage is 
limited to 256.) 

Relative byte Function 
in the DIREC 
bit 7 

File primary directory entry (FPDE). 

1 File extended directory entry (FXDE). 

bit 6 If set indicates a system fiLe. 

bit 5 If set indicates a non-VFU file. 

bit 4 If set indicates an active file. 

bit 3 If set indicates an Invisible file. 

bit 2,1,0 Contain the files protection level. 

1 bit 7,6,5,4 Unusevi by MULT l DOS. 

1 bit 3,2,1,0 The month the file was created/updated. 

2 bit 7,6,5,4,3 The day the file was created/updated. 

2 bit 2,1,0 The year (offset by 1980) the file was created/updated. 

3 The end of file byte. 

4 The logical record length (LRL) . 
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5 through 12 
13 through 15 
16 and 17 

r J 

18 and 19 
20 and 21 
22 through 29 
30 through 31 



SYSTEM UTILITIES 
The filename padded to the right with spaces. 

The extention padded to the right with spaces 

Update password hash code. 

Access password hash code. 



Last physical record. 



Contain four segment fields. 



Pointer to FXDE. 



DIREC+00 

This byte contains several attributes of a file. 

Bit 7 - If this bit is zero, then this DIREC is the file's primary 
directory entry (FPDE). If this bit is one, then this DIREC' is the 
file's extended directory entry (FXDE). Extended entries are 
required when a file has more than four segments and/or the file i3 
larger than 128 granule. 

Bit 6 - SYS tern files must have this bit set. - 

Bit 5 - If this bit is set, then VFU will not access the file. 

Bit 4 - This Is the bit to indicate if a file is active or not, regardless 
of the other bits in DIREC+00, or bytes in the DIREC. If this bit 
is set, then the file is active. 

Bit 3 - If the bit is one, then the filename is hidden to directory display 
or print unless the invisible parameter is specified. 

Bits 2-0 - Contain the protection level of the file. 

DIREC +01 '■- . 

In a FPDE, this byte contains two zones. The first zone (bits 7,6,5,4) are 
not altered or used by MULTIDOS. The remaining bits, 3-0 are used to store 
the month portion of the date of the last file update. 

In a FXDE, this byte is the reverse pointer to the previous FXDE or FPDE. 
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DIREC+01 

In a FPDE, this byte contains two /.onns. The first zone (bits 7,6,5,4) are 
not altered or used by MULTIOOS. Thf r-raalning bits, 3-0 are used to store 
the month portion of the date of the last file update. 

In a FXDE, this byte Is the traverse pointer to the previous FXDE or FPDE. 



DIREC+02 

This byte contains the balance of the file's date information. Bits 3-7 
contain the day of the month, and bis 9-2 contain the year offset by 1980. 

DIREC+03 

The value of this byte indicates how -nany bytes the file extends into its 
last record. 

DIREC+04 

This byte contains the file's logical record length. 

DIREC+05 through DlREC+12 

These bytes contain the filename. The flLeuame is left justified and padded 
with spaces. 

DIREC+13 through DlREC+15 

These bytes contain the extension. The extension is left justified and 
padded with spaces. 



DIREC+16 and DIREC+17 

i 

J These bytes contain the hash code for the update password 



DIREC+18 ans DIREC+19 

These bytes contain the- hash code for the access password 



j ;-, DIREC+20 and DIREC+21 

These two bytes contain the total number of sectors occupied by the file 
I 
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DIREC+22 through DIREC+29 

These bytes, used as pairs, form four segment fields. If the first byte is 

an X'FF", then the file is contained in the previous segment fields. (If 

DIREC+22 - X'FF', then the file uses no disk space.) If the first byte is 
X'OO' through X'FD" (X'FE" is not used!), then it represents the cylinder 

this file segment starts on. The second byte has the starting granule in 

bits 7-5, and the number of contiguous granules less one in bits 4-0, for 
the cylinder in the first byte. 

DIREC+30 and DIREC+31 

These bytes point to a FXDE if DIREC+30 is a X'FE' , otherwise DIREC+30 must 
be a X'FF'. 

DIREC+02 through DIREC+21 are not used for FXDE's. 



OTHER BYTES IN THE GAT SECTOR FOR EARLIER VERSION'S OF MULTIDOS 

Bytes X"C0" through X'CB' GAT usage has varied with the MODEL as well as 
versions of MULTIDOS. These bytes were used for system and forms storage. 
Version 1.7 of MULTIDOS does not use these bytes. 

BYTE 

CO Configuration pattern for DRIVE// 

CI Configuration pattern for DRIVE// L 

C2 Configuration pattern for DRIVE// 2 

C3 Configuration pattern for DRIVE// 3 

C4 Bits 7-5 are the power-up bits for SMO. Bits 4-0 is the number of 

disk I/O tries less one. (Version 1.6) 

This byte Is the OUT 254, (value) for speed-up mods on MODEL I 
version 1.4/1.5 or the byte for OUT 95, (value) for MODEL III 

.'"*.*' version 1.3. 

C6 The FORMS line width. 

C7 The FORMS "S" parameter. (If pagination active the high bit is 
set.) 

C8 AUTO invincible byte. (X'21' if AUTO command is invincible.) 

C9 Keyboard defaults. The bits vary between versions and models. 

CA Default cursor character. 

CB The BCD representation of MODEL I version 1.5 or prior, MODEL III 
version 1.3/1.2/1.1/1.0. 
Version 1.6 uses this byte for FORMS parameters. 
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HEX 


DECIMAL 


00 





03 


3 


04 


4 


05 


5 


06 


6 


08 


8 


OB 


11 


OC 


12 


OD 


13 


OE 


14 


OF 


15 


10 


16 


11 


17 


12 


18 


13 


19 


14 


20 


15 


21 


16 


22 


17 


23 


18 


24 


19 


25 


1A 


26 


IB 


27 


1C 


28 


ID 


29 


IE 


30 


IF 


31 


20 


32 


22 


34 


23 


35 


25 


37 


26 


38 


27 


39 



MULTIDOS ERROR MESSAGES 



SK'IOR MESSAGE 



Mo error, 

Lo«;t lata during rend. 

Parity error daring read. 

Dat.i record not found during read 

Attempted to read system data record. 

Drive not available. 

Lost data during write. 

Parity error during write. 

Data record not found during write. 

Write fault on disk drive. 

Write protected media. 

Drive not available. 

Directory read error. 

Directory write error. 

Improper file name. 

Granule allocation table read error. 

Granule allocation table write error. 

Hash index table read error. 

Hash index table write error. 

File not in directory. 

File access denied. 

Directory space full. 

Disk space full. 

End of file encountered. 

No record found. 

Full directory. File can't be extended. 

Program not found. 

improper drive number specified. 

Load file format error. 

Memory fault. 

Access attempted to protected file. 

File has not been opened. 

Drive configuration one volume. 

When an error occurs involving the directory, MULTIDOS will generate two 

error messages. For example, if the disk in drive zero is write 

J protected, and an AUTO command is issued, MULTIDOS will respond 

wi th : 

Granule allocation table write error. 
] Write protected media. 

Use the second error message in resolving the problem. 

) 

ERROR MESSAGE BREIF DEFINITION 

i Access attempted to protected file- - ACCESS password given, but UPDATE 

' password required. 



) 



I 



Attempted to read system data record. - Disk read of a directory cylinder 
without going thru the MULTIDOS directory read routine. 
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Data record not found during read/write. - The track, side, or sector 
number is not found. This error can be caused by a flawed disk or a 
diskette formatted with a different TPT than the drive it is in. 

Directory read/write error. - A read/write operation, involving the 
directory, failed. Refer to the second error message. 

Directory space full. - All DIREC slots are used. See ZAP for DIREC detail. 

Disk space full. - All granules have been assigned. 

Drive not available. - Diskette not spinning in selected drive. 

Drive not configured double sided two volume. - Side one selected for a 
logical drive with a single volume configuration. 

End of file encountered. - An attempt is made to read 1 unit past the EOF. 

File access denied. - Incorrect password given. 

File has not been opened. - An I/O attempt was made to an unopened file. 

File not in directory. - Filespec is not in the specified directory. 

Full directory. File can't be extended. - A file is being expanded and 
requires an extended entry; however, there are no DIREC slots 
available. 

Granule allocation table read/write error. - A read/write operation, 
involving the GAT, failed. Refer to the second error message. 

Hash index table read/write error. - A read/write operation, involving the 
HIT, failed. Refer to the second error message. 

Improper drive number specified. - The drivespec given to MULTIDOS is not 
in the range of thru 7. 

Improper file name. - Filespec syntax incorrect, or no filespec given. 

Load file format error. - Load routine didn't know where to put the file. 

Lost data during read/write. - Disk I/O loop to slow, or hardware problem. 

Memory fa»:lt. - Load routine detected a bad RAM byte or no RAM. 

No record found. - An attempt is made to read more than one unit past the 
end of file. 

Parity error during read/write. - A sector read/write operation failed. 

Program not found. - Filespec is not on any mounted diskette. 

Write fault on disk drive, - Definitely a hardware problem. 

Write protected media. - A write attempt to a write protected disk. 
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j. « J ,.y; » • 

•^— ^ . . • . ... ' .. 



a 



^ . ..'.,": SUPERB ASIC 

'iP-i'l' ' .■"•"" ' • SUPERBASIC Hiijh level language Interpreter. 

^.- ; . ; # .BASIC[ ff[V]][,mm][,coinni.ind]<ENTER> 

v.': •;•■' •'. "" ... ff = number of file buffer areas allocated (0-15) default 3 

• . ■ V = user defined random I/O flag. ' 

nun = memory protect addresses. 

. _ command = Any valid BASIC command. 

A mandatory space is required after "BASIC" if any of the optional 
■■' - parameters are specified. A comma will indicate a multiple command. 

;,"' EXAMPLES: .' 

*/■—'- -\' : '" *" BASIC<ENTER> , • . 



: -\T" / 









'^i^^^VV SUPERBASIC will load with 3 file buffer areas allocated (289 bytes for each ..•/$.;" 
■;{€^V./ . : 'i : : - •:.;.• .'•:. file buffer area), and all RAM up to TOPKEM available for use. .... •. - -Cyi:- 

'H~4y\\': ..' "■•-.•' '•.': .'-..'-.BASIC 4<ENTER> ' ,'. <\ v "• 

~\j£'^A-X -V-'v •■-•■' "..".: /V ••■• -• ..-•.•: .>.?v. 

'^vV - "/ SUPERBASIC will load with 4 file buffer areas allocated, and all RAM up to ^' '" 

.'*,■' :--•- TOPMEM available for use. • - "; 

'"■•';.r^ BASIC 2V, 60000, RUN "PR0G1/BAS"<ENTER> - \ . § 

SUPERBASIC will load with 2 expanded file buffer areas allocated (545 bytes 

each), capable of handling user defined record lengths (1 to 256), 

..'-;.'• ;. RAM from 60000 up will not be available to SUPERBASIC, and the 

•'■ program "PR0G1/BAS" will be loaded by SUPERBASIC and executed .,...■-/.:<■ 
V ' ; , starting with the first program line.. */ " :;': 



m 









J 









-'.•,- i .;. s »..v.>-.- 



•< 'i. 



;>>.^.y': : . - should use the CMD"uuuuu" function from within SUPERBASIC. 



* r «"»> 



-. ??,v„'.: 



L- -.fj:"".-'"" 

] 



This command assumes SUPERBASIC was previously loaded Into your system, you 
, . •'. now have the MULTIDOS prompt, and you want to return to SUPERBASIC 
with the previous program unchanged with variables Intact. :,. 

CAUTION: You cannot go from SUPERBASIC to' MULTIDOS, execute commands such 
as : "DIR" and then use "BASIC *" to return. In such cases you 



If the return to SUPERBASIC was successful, a 'Continue? ' prompt will 
appear. Enter "Y" if you want the program to continue (works even 
after re -boots). . .-- . .■...- ... 



•i'ftVv '"■:-• •' •,•...-.■.. ._.,.. Page 75 



v; vf 



X >: 






-V.-r- 



V'^V- 



• .'•'.'■'-/ BASIC * .'' Recover BASIC program. .•-,--. >* V: 

f y' r '. -'■<■/ -.BASIC *<ENTER> '•/.-' ' •'•'-'' . - .*•••. _ ••■•••■• ; - , : -.: ■]■*■$%?[ 






*U-:fV- 






;•;:• - SUPERBASIC 

BASIC ! Capture a BASIC program from RAM. 
BASIC !<ENTER> 



This 



unique command will transfer a BASIC program, previously in RAM, to 
SUPERBASIC. With a BASIC program in RAM, insert your MULTEDOS disk 
into drive and press reset. When the MULTIDOS prompt appears, 
enter BASIC !. 



BASIC § . . Recover a LEVEL LI BASIC program. 

•,\;-7 : . . BASIC //<ENTER> 

This command" is used to transfer a program from LEVEL II BASIC back to 

SUPERBASIC, providing LEVEL II BASIC was entered via CMD "W" . This 

••>■-. . feature will allow you to work in a LEVEL II environment to develop 

'.'.•/ programs or to transfer a sensitive LEVEL II program from tape to 

/ : - : ^' v :' disk. -..'............;* 

MULTIDOS uses SUPERBASIC's CMD "W" function to enter LEVEL II BASIC. You 

.;- may use CMD "W" with or without a program in RAM. If a program is 

/'.' " in RAM, it -.will be transferred to LEVEL II BASIC with text 

'V* '• retained. To exit from LEVEL II BASIC to SUPERBASIC with the 

'■••'■•■'.•;•• program intact, key SYSTEM<ENTER>, answer the *'*?" With '716480", 

VJ.y. •"•" hold down the enter key and wait for the MULTIDOS prompt. Enter 

, v'-' ". "BASIC //" as shown above. 



■ *.-■ »■"*•• 



, v-'.".' 



.' -■ '■■ -Jiffs 






BBASIC 



BBASIC 



d^-\;-: 



..;^-There 



Enhanced SUPERBASIC. 

has all of the features of SUPERBASIC with the addition of single 
step, trace, variable review, and program pushing functions. Upon 
entering BBASIC, the <@> key becomes a control key. The "@" 
character is printed by pressing <SHIFTXSPACE-BAR>. 






are' several additional functions available with BBASIC. These 
•' functions are Invoked by pressing down the key with the "@" symbol 
first then, without removing your finger from this key, press one 
" of the keys on the top row of the keyboard. Some of these same 
functions can be obtained thru program execution by poking an 
appropriate number into 16667 (411BH). This is ROM's trace on/off 
*\$&&i'&'''}' : byte. With the incorporation of these new trace functions, the TRON 
^&/? : -r--i'&'\ : }'' '■' and TROFF functions are disabled. 

f^JThe functions will be described with an "@" symbol preceding a character. 
:'4,j^v:~^;. ', This represents pressing the <@> key along with the key following 

v^-jS^-v..'; • . the "@". 

TRACE OFF 

This will turn off all trace functions. 
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"v^'lV u .'.\'.. 




'•>*¥> *'~-'J*"-/ r 




v* •-i'viV '".:.'; •"' 








< .' 






^• rr 3T 



?ci/- 5 \t^.;^V'*" ■• ••;•.. 



■ . i •*»- ■ 






SUPERB AS IC 



' v-V\--v;/. V'V: ■',..;! ,; :r' @2 TRACE ON - VIDEO . • 

J , '•"' V:',.. ". : '•■•-;. This function traces the last four lines executed, in the upper 

•:-'"'•"* v • • -■'-"•- ' . right hand corner of the display. As a new line is entered its 

~ V':""!S / . ''•' " number will appear prefixed by the "//" sign. If more than four 

. i 'V.'. .' ',;:' ': ' lines have been executed the trace will start at the top and 

■ . -"'i, •'.;••.' •• ' • overprint the previously displayed line number. 

"| : -'"">:'-J ,-'.:••. @3 TRACE ON - PRINTER 

\- '• This function will direct the trace to the printer in the format 

. •'-••''.•'* ' space, 10k digit, Ik digit, 100's digit, 10's digit, and unit 

.,:-*:■.._. digit. Zero suppression is used and each line requires six 

1 .. '•,•/, ... character positions. The trace information will show the 

J" V"' ~ complete program flow, but will only be printed when an entire 

: ,- V' •■ print line is available, unless a character at a time printer is 

'."."•■.•.• being used. e.g. TELETYPE. 

Vi;'v;,, • . . SINGLE STEPPING .. ; ._ .'/V ;'"'.'.'• '•"'' '• '_. " 

1 ' u ^.'.' v '''' '•■' You can single step individual lines of a BASIC program or individual 
J "V"/v. •" '"■ instructions within a line. In addition, you can vary the delay in which 
.. ■ ' your program steps between lines or individual instructions. 

@4 """"' SINGLE STEP OFF 

. - This function will turn off the single step function and allow 

-\ " your program to run as normal. If the trace function was in use, 

J It will continue to function until turned off via <@i>. 

--•..••■•*'• @5 SINGLE STEP TO THE END OF LINE 

■ .- w . This function will execute one program line then wait until any 

:•• " ,"..;-_.'.' . "" key is pressed. The trace to video display mode will also be 

.-,'. :".'.•' -. initiated to show the line numbers being executed. The tracing 

..: ..!.' function can be disabled by a <@1>, while the'single step mode 

' V-. -"'.'- :'. : . ■ continues. 



I 



i 



\ 



i "- V 1 -:'!. .-','..-:. •'; @6 SINGLE STEP INSTRUCTION -. ■ ' ' 

.'.V?r ;.'. :• '// '; This function will execute one BASIC instruction then wait until 

_'-:*.';;•'.' <•-•- v .:, ".' any k e y ± s pressed. The trace to video display mode will be 

] : ;-'" : .\" ? . *'.: ■■■';. •.-.•• • initiated to show the line numbers being executed. This function 

J .:/.'..;• ''■'.'■ - can be useful, but be wary of using it if a program contains 






^>:^'->x: : "■ 



lines such as: . ■_. , •;..;• , • - . t - . , *'y'?}\ 

90 FOR X=l TO 100:A(X)=6+3*X*Z:NEXT X 'V 



1« y\y : " : )' - . mis tunction will execuce one program xine or mstrucuuu, 

-. V : .— -' pause for a predetermined amount of time, then continue. The 

; v J .Vv ". ■ -■ ■ trace to video will be initiated to show the line numbers being 



/; 


..-11 -*■»...-■ 


-'.' 


\0& 


\l, 





To single step through this loop would require 300 presses of a 
key. Instead use SINGLE STEP TO END OF LINE for this type of ..^.K; 

* •■• line. ......... . . •.'.'•v-C't*'^ 4 

-•"'.- - • ■ ■ "• . . . :. -m^. 

@7 SINGLE STEP WITH TIMED WAIT '• • T \V» 

This function will execute one program line or instruction, vr; 



'••', VVj".-" 



. . » .. ' "'■ 



: m 

-1 "•:"'^-".-^-' ^ ;.';V 



executed. <@5> and <@6> become sub-functions after <@7> la 
initiated. Pressing <@6> after <@7> is initiated will cause the 
delay to occur at an instruction separator, in addition to the 
end of a line. Pressing <@5> will cause the delay to occur at 
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''V^Ct'tV'^ \ ' ;<- : - '.:■■' } '-•■''. ''• .!••■-: . ...--.-i-v ■'•;'.■:••" ■■•• . ■*'••.' "'•" . . • • 

. .i\y-\: ■■:" .'':•-•«;. superbasic 

•■.. .;v; : .-"■'•''■'. ' .-•,.. tne end of a line only. To speed up execution (decrease delay) 

'■.';'•' .' .. ; . press <@up-arrow> (halves delay). To slow down execution - 

: v '' '" ' increase delay - press <@down -arrow) (doubles delay). The delay 

,-.,;'; . " has nine settings from approximately 4 milliseconds to 0.9 

\ - ; ; . '':"'' seconds at normal CPU speeds* 

... ;' '.BREAK POINTS 

The trace and single step functions previously described can be invoked 
-.' while a program is running by inserting as many POKE instructions in the 
... :'■ program where the functions will initiates. The following codes are used: 



FUNCTION _ - . POKE L6667, 

TRACE OFF 1 

TRACE ON - VIDEO 2 

TRACE ON - PRINTER 3 

SINGLE STEP OFF 4 

SINGLE STEP TO END OF LINE 5 • - 

SINGLE STEP INSTRUCTION 6 

SINGLE STEP WITH TIMED WAIT 7 



KEY equivalent 

• @3 V.' f 
.'/-.•••.. @5 -«:■:. 



EXAMPLES : 



If normal program execution Is desired until line 1540, then single step 
:* with trace to the screen required, insert, just prior to line 1540, the 
v Instruction "POKE 16667,5". 



(users text) 



^;^^ ,;../,",:(•- EXAMPLE 1 EXAMPLE 2 

'.t— *-> : 153 ° ( user s text) 1530 (users text) 

&??/&£ r y; 1535 POKE 16667,5 1540 POKE 16667,5 
•W&^h;?-:--- 1^40 (users text) 

SiT Multiple' POKE'S are permitted. 

''f&zg&Vzfr-'*' -■-.-■ v '* *•=;.*'» ... •-'-._ y 

J "^^P^r'^-: :: POKE16667,7:POKE16667,6:POKE16667,l 

A*$sVS-/ •.'■■■: ..■•.-.-... . . • 

$&&Jr;Thls will invoke "SINGLE STEP WITH TIMED WAIT" between instructions with 
V~*|£T-' the trace disabled. 

' )$*i'£Zf~,£t ••''' "'■ . 't".' '•'•■ "'■ • •". • , • . ■'"'':.'•■'', -i ■ ■ - ..- r - ; "^ .;■''/' 

M^SELECTING/REVIEWING VARIABLES - . :/> : [>••' 

: ^K BBASIC wil1 suspend program execution to select or review variables then 
;£0£ resume execution and restore the display. If there is insufficient memory 
$£*£':■: to save the contents of the video display, a graphic block will appear in 
>)^-5 , the u PPer right hand portion of the screen - to the left of the line number 
v-v-'&^trace region, and the program continues. 
^'-^r^'ii-V-r** .'!_.'-.■•- ■.'.•".: ■ . * 

.t?fe'iiv:?r-- : '•■.■'.'■•". 

r S7/^>;Pr- - • ■ ■,•••., ■ 

^•V^V-V-;.' • ... 

" j0.:' • - ; , 
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^K^-A- :-.'.. ' - . ... . .'. ; :. - .:,•:; 









i/^fi.-AVV.'.s',-'. ■ *•"■*.••.. •".'- •• •• ' .IV" • .. 



.v. „.-•:••> \\ SUPERBASIC 

J^:r'\\'''.''. SELECTING VARIABLES 

'"'.'/" .*. * »@N = select variables foe review 

•"•'.. , Pressing <@N> selects the variables to review during program execution. 

:'--''"■ '* This command can be entered at any time, before the program is ran or 
■ U -C-.... during program execution. After invoking <@N>, the screen will clear and .*.',.. 

"'■■*. ". , the query 'Length? ' will be displayed. Respond from the following choices: 

.': -■•" ■ ."• ". . response '. : ;'. : :; ''V .=>'.;.. ; .. RESULT .! : , s ";v 

: 1 •• /. ' . . BREAK exit function & return to BASIC program . ' , " 
-, * ; 1 1 character variable names . " . .7. >/. 
i\s '.■■': /.'■"■ .■'•'.-. 2 or 3 maximum of 3 character variable names ., ..• : ''v• 
;. !: :\•..•• . ' • . ..'"•"• 4-7 maximum of 7 character variable names >• '•••V-\' 5 : 
''/*-;>:"...►■;■ . ' . 8-15 maximum of 15 character variable names ' ,, -\/- ; ; 
'■'.'i;VA;s?" r :-\; " 16 - 31 maximum of 3i character variable names " ' . f ' >, l-C: 
"Ji v .'-" : ' ' • •■ ENTER default to maximum of 7 character names .••■-■. - : • •'• r^V^i.-; 
bth-J-r.fv';:.' ".'.•.-'.••■•'■''■'•• -... ••*.•; :'' . .■■ •:-'_.". 'a';." 



,r * -' 



",£.'.' •' v = '. The. maximum number of variables for review is limited by the maximum ' : il^' 
r\^ •:',,. variable, name length selected, as shown below. ' ".■*<'?M^' 



. -T''l* 



. i' "" '• . / .' 



' NAME LENGTH NUMBER OF VARIABLES TO REVIEW " ,: \. 

1 maximum of 128 

2 -3 maximum of 64 \ " 

4-7 maximum of 32 ..-V 

8-15 maximum of 16 

16-31 . maximum of 8 . ■;';. 

NOTE: The name length includes all characters. The variable name A$(21,5) : - 
is considered to have a length of eight. F(R(3,8)) is nine characters in . '. :..^. 
length. After successfully entering a variable length, the message 'Input.' - ^.;- 
will be displayed and all previously entered variable choices will be / .' V 
erased. <@N> accepts simple as well as complex variables. Such as: ' ->*- 



A 


. X! 


B// 


QKF(G,Q)) 


K$ .'\:* 


A!(F(G,Q)) 


F(2,3) 


T//(F,(B(A,N),G(E))) 


A(B) .., 


r - :.'.•: WEEKDAY 


S% 


A(B,C) 



. , .. . ....... ■ • ••; •.•■• . "• : ' •' -'•> V^-J/'w 

'.*'-•. '' : ■■■ ■■'''' ' '. "' "' •' . . .'.: •;';'.' >>;W»* t"'* 

Any number of parentheses are allowed, and algebraic hierarchy is ^;I^ 
maintained. Although erroneous variable names such as A$3 or A(3H) are not "^^/ 
rejected," they will cause errors later when a review of the variables Is ''"V'v? 
attempted. . , . . 

Once all of the variables to review are entered, press <BREAK> to continue 
with the review. If the maximum number of variables allowed are entered,, 
BBASIC will automatically proceed with the review. At this point BBASIC 
invokes an <@0> as described below. 



:»'•>■ V-: 
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;.'..".'1 • ". ' •'.. : ; superbasic 
''"reviewing variables' ' '•.' 

. .;';.,-.. 00 « review the selected variables 

.•;. . Pressing <@0> during program execution will immediately save the contents 
of the video display and the message: 

'/''.- ■. .'<C>hange <D>elete <I>nsert.' 

will appear along with the first variable for review and its value. "' 
Variables are displayed in the order entered with the <@N> function.. 

Pressing <CLEAR> will cause the message 'End.' to appear. If the reviewing ' 
...of the variables is complete, press <CLEAR> again to resume program 
execution and return the original video display. Any other key will start 
at the beginning of the variable rewiew. . ..... 

- Pressing <C> will erase the last variable displayed, and put the user in an 

input mode. The new variable selected and its value will be displayed '"' ' '/ 

./.. ...immediately after, entered. Remember, the variable name is limited in length \' :: " y '5". ,-,-«. 

- per the original choice when <@N> was selected. • ,• : : ; \v-';- • 'y^v????* 

.. Pressing <D> will delete the last displayed variable. . . ' .. -WV '* ''' ■ " : J''^' 

Pressing <I> will insert a variable PRIOR to the last displayed variable. .':"' : '.y' 

"Pressing any key other than <CLEAR>, <C>, <D>, or <I> will advance the ' " : - 

display to the next variable selected. 

If an attempt to review a variable whose subscript is out of range or with 
an illegal name, the message 'Redo!' will be displayed and the <G> command 
; will be invoked. A valid variable is required to exit from this command. ' -' ' 

..• If an element of an array (subscript < 11) is reviewed and the array has 
.. not yet been dimensioned by the program, this array will be dimensioned for 
..{•"eleven elements (0-10). If the program subsequently attempts to dimension 

• ^.this array via the "DIM" instruction, an error will occur. Dimension all ' 

. .-.^" used arrays before review. ■ , 

■■■if:' STACKING BASIC PROGRAMS ' '*,"'.. . ' •■ ' 

■>.Vv"'"'.- : - .■ ..."•■-■■ - ..-■'. -...,, 

v^. BASIC Programs may be stacked (saved) into high memory while working or 
••y,;^ .running another program. Of course, this ability is limited by the amount 
■ ^,.of free memory space available. There are five commands for this function. 

:k. { §"' " Save the current BASIC program in high memory " •'':'"' 

;•'. @ : ',* Recall the last saved program from memory •'•'• 

\'/yr @ 8 " Append the last saved program to the current program 

V' @9 =» Append the next to last saved program to the current program 

,r., (20 = Recall the next to last saved program 







,3 
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>:*> 



'•>, ./ ■ 



-V •.'. • ., SUPERBASIC 

Pressing <@-> will copy the resident program into high memory and adjust 
memory size to the beginning of the saved program, thus protecting it from 
BASIC. The original program will be left available in BASIC RAM, if memory 
permits. Since memory size is adjusted, subsequent saves can be made as 
desired. When a program is saved, a tall vertical bar will appear in the 
upper right hand corner of the video display - to the right of the line 
number trace region, indicating a program has been saved into high memory 
and a program is in BASIC memory for user execution or modification. If 
Insufficient memory is available to save a program and also maintain it in 
BASIC RAM (i.e. saving a 30K program in a 48K machine), the program will be 
saved and a "NEW" Invoked. This condition will be indicated by a clear 
screen with a small block in the upper right of the video display. 

Pressing <@:> will recall the last saved program from high memory, 
overlaying the resident program and adjusting memory size. If no saved 
program remains, the error message "NOTHING TO POP" will be displayed. 

Pressing <@0> will recall the next to the last saved program from high 
memory, overlaying the resident program and adjusting memory size. <@0> 
provides a means to switch the resident program with the last saved program 
by saving the current program via the <@-> command and then recall the next 
to the last program via the <@0> command. / / . 

Pressing <@8> will recall the last saved program and append it to the 
resident program. 

Pressing <@9> will recall the next to last saved program and append it to 
the resident program. 

Line number sequence is mandatory for proper execution of the appending 

commands. The recalled program should have its lowest line number greater 

than the highest line number in the current program in BASIC RAM. The <@8> 
nad <@9> commands append, they do not merge. 



■f . /.• 



9 *v:.i!>.v \. :■ 

1 -.srrnvv 

1 . .^-vriZii " 


• .-T"-'. > ■ 




: " ' V'V* 




• . 'f,. _•• 


I " •* "• ■ • " ; , '.j 


'..'"<";<•;.' 



L.-*-.- : 



SINGLE KEYSTROKE COMMANDS 

:■•■./**">••'■ . (period) 
• •-. • • ;:" , (comma) 
/ (slash) 
. , . up -arrow 
\V.'- down -arrow 

.... shif t-up -arrow 
r shif t-right-arrow 



list current line 
edit current line 
list "BREAK in" line 
list previous line 
list next line 
list first program line 
list last program line 



The single keystroke commands are recognized only if they are the first 
keystroke after the BASIC prompt, '>', appears. If some other key is 
pressed, press <BREAK> to enter a single keystroke command. 



■4 - 

■ : : iJ '■ 
l**** 



'mi- 



) 
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"j ^'.W - \£i?y ~y^' i t'.' ■".'" ■:?"'""< *•';*■." ■•'■~'" > ' •■; "* • ••'.* '"j -•:-,. ' ' •' --''-«..••': 

^^■"'•V; :; ?:^1rv.^ : - : :'v^: J;^ :-- :yy ! :, super 






SUPERBASIC 

>.' "^SINGLE LETTER COMMANDS \..VV" /■ '^ -X,'/' ; . ;*.•■:•'%•■• •■•= ■ -,.■ .•■ ..•;'•.,..,.; : / : -V^ 

; >y?£*&* i '^':'{^':.^-:r:t.l .■'•;*■■•■?•>>■■■"■'■■ *,'.' ..-.■■.- v.- , : ; : . .. . , . . ,,. ,.-. .-;^-.. 

'•.!i^:V4"-:»...'" ■•■•>>■.••!.•;.?.'..;.;.'-:-' A = AUTO ' • • ' . ■ .. • 

' v :\v- - C - CONT • .•■;• ■•.."•>•■-■• ■ '■•»• .'',>■ 

v-:^'.-" D = DELETE • . ; ../ : - . ' • . , ., •,'•••••. 

•-" .;•_,>•, ' E - EDIT •'•.- •.'••; •:/.' .-...• . ; 
'-•''•- I = AUTO(curreat ILne + I), I [INSERT] 

K"filespec = KILL"f ilespec" - • v" 

L = LIST •."'•' •:' ' '•'??" 

L"filespec = LOAD"f ilespec" \ ' • ' • •.'••" " - -c. • 

Mlnl,ln2 = move lnl to ln.2 ••*•■ - '••'-' • ... . '.''•'+?■,? 

',' Mini,. = move lnl to current line .• ...,-•• .-..,...: ., , , .' ;/ y;o, 

M.,ln2 = move current line to ln2 ",■,•'•"•'•"•.■,'.•. i"!" :xf"" > ' 

■ Nlnl,ln2 = duplicate lnl as ln2 ' / " '> ;.'• ; : '•. : r,^'" 

';'•" Nlnl,. = duplicate lnl as current line '■?'".'. ; \ ■ iJ< .,, f ':;-,.' '/,.'.. .. .' ~ : :'\ : : '* % .> *jy*$X 

" . N.,ln2 = duplicate current line as ln2 ■''[',, ;'/ ' I ']'>•';? f/j 

P = list page from current line T - -• : " ;.::■' j--vvf^ : ' 

';. : Vi Pin = list page from line In : .. • ... ' - "■■ '-^'v 

r " : ••;'' ' r = run program ,-■' ■'" "• •" '.' , "' .-.., ' •. ' . ■.•■'•" "."J ■'-v'-^'/- 

.i'F?3$*ZV:*:''%*'^-' R"filespec = RUN"filespec" •••'- ■■■ - ■= 'V,''^-'.. '.V ■•-.-,;;. ■■ ••.•,..../.,.. ^..,...: ; ^^^ 
.^v^fet.-'.-'r? r -J;*v.^ s"filespec* = SAVE"f ilespec" ; - .-,!> v ;;•> • ( /^^,, =■ ■ ..-,, -..^ ; ; \;f:^.' ; ;f^^ ; 



;•.; • ;^ v ',".\ j-;:jr ;. 


j' 1 


'■'*-;,: ,«;"-•" 












'* '•'tl : S'^''.1 
















•-I {..*-■"• ," ; - . 


».■ :»•«"•■ > rji>-.»» ; - 


- 


• !. v }>• ,. < 




r 


; ^' ""H " ' 


• .■ *.-t •► <• . ■ 








.- 


•>."- i r7'".- " 




















..i. v t'jii^"- 




j,/ .- i_ '■ " . 


;.'r- rt. /•.-! J » : ■ 












:."'."j»L' ' ■ •*, v "r«. - .' ; '; 




— -i - '*- * . 


■ r -H?i^' :i 




"•"'. -x.-V. • 


f:^~i^-' 


■ # . 


-'f~.~ «-«►*",•: 






-" ~ ."< ' * 


.."• '■'" •4^' ' 




• ■ '." t \ 


:' ■'???'££):. •■'♦ ' : ' 




'. '--''.' "^ •" .. 


-'• ■■ .— ■» -";•>»£• »" . .. 






' - -^r' -•• V ' . . 










''i^l- ^ 














.^^^rijv.-T 1 ^'* ''."?• 




.•'■j..'. ti",' :■•,'' 



:.;..-. The above commands are terminated with <ENTER>. 






^■*;'A line number followed by <ENTELO> will list the line. To delete a line you 
,'y must use D or DELETE, followed by the line number (optional) then <ENTER>. 

?.•;»'■ ^.Vrt'- ■-•• •' ■•'*'-.■ ' "*'.' '" ■ ' ' ,: ~ ''■■■■„'' • ■ • ■ 

.The 'W command will relocate lnl to ln2 , deleting lnl, and inserting it as 
•ln2. If ln2 existed prior to the move it will be replaced by lnl. The "." 
.-,;- r .C may . be used to refer to the current line. 

l-^The 'N' command will duplicate lnl as ln2 while leaving lnl intact. If ln2 
.N'-Cv existed prior to this command, it will be replaced by lnl. The "," may be 
ViV'used to refer to the current line. : - 

7;^". EXAMPLE: This BASIC program is in memory and the current line is 20. . / 

-^t^f't" .'.'^•"16 For X= 1 to'20 \ ;'- : / '"-f ' - - " : ; ~ v "' '"/. 

:>J2§&*-~''""; 20 PRINT X, X*X, X*X*X ' •••- _. ''■>'•■'.-•/•■■■'' ' '■ 

: ^&^&^ :i ' 30 NEXT X .:-,'. ; .• "-> L . > ■■ ■ ' -.■ . y -. ..•.<■>.■.'/..:■.•>;. ■ •.-■..";•' 

; %fgp^:^:'; :"__40 END y; ; ; A ; '■ • " '-- • - ; : - - •'' •.'•';.•/:•, =""' '■"/.:> 

! W£0£-' J •;'''" l<enter> "i-V:- ,■ ;_'-y--- V; •; •-.:;•" ■ .-" v ' ,^ . .' i '. ;' " •••'' "/i'].; ■::'.:■ '-' : fy 

;^v£f Then.'.'. ; Line 20 will be listed. ''-•> y' -\ . - v-v , r 7 - : • > . v- •: 

-'^•'•^V^^ :-:"--^."^-''-' " '"-"''•''-:% •-'• .-'- ; -.'- : ''' : '. .'■■'■.'■'- ; - ; :^-'-' ; ' ' ' ■"-■ '-'' ' ~ : i'"r - : .-'"'V'- -. ! Y .--r. /';;!;- /'f.' 

:^f.^If/;:;- L-.<ENTER^ : . ; •-•.. ■.;..>■.....-.,..,, .. . .. ./;,.^ 

•^ifei Then h ! Lines 10 and 20 will be listed. ! '^ , ,: '! ^ : 5 :.r . ' 

•^Ttf^t^,:. ••V^ 4 -- r • ' r -V;. :!. .: "■ '•-• .,-V .. , .■:,-.• ^ .:■;;■ ...V^. • , ..Y- - ••■ . '■ 

'^$i.If ■ ' - •- L.-<ENTER>-' ■ -v • • - •"••• V -/ • .. • '-r„ -.i^;" 

"cl^Then ' Lines 20, 30, and 40 will be listed. .." , 

"'?■*•*£ -js&;y ' ' -■■■■ . 

'SSK if ' ' .' •.■■■"• 

^iV>kvThen Line 20 will be listed. 

^ ^Fage 82 " ". : ' " ■ / • ' .■ •'*■' ! '-.'-'•"-''• V. . 

^•»»;j>j' Si",.., ' *• , '.•.•;<.;. 






ii $y 







OYY 



-Y^YY'; 



rK^i&f-^'^ - ' '''■"*". 

's^V^^t^^ ' : :r ''"' ; "' :: --- y-. ' ^ •■ "- • \ .. 

0^;. : v. - yy '"•'•■ Y Y" •'"•'. "~ ' " Y ' "• • 

r ^ri^ ; ^Y;' Y - " '''■•■■ \ ; ; - '■'•• ■-' YYY-- "■"'■ ;"• -t V' *' • •'■' ' ! ' : : ""' Y'" : ^' '" : ' ■ - ' ^ ■ •_..; 

■v'.; Y;>-..-: "-. "■■•'. ••"' ■ Y ' superbasic ■■■ 

; " &H and &0 Hex and octal constants. . • , .' 

: .y ' &[H]dddd 
' • ~ &Odddd 

•V This command will permit the use of hexadecimal (base 16) or octal (base 8) 
--"' constants within a program. The "H" is optional in SUPERBASIC. 



Y--<:: •. 
.Yv£\.V 



EXAMPLE: 



X = &4000 

Y = &6000 - &5200 

POKE &FFFD, 4 



This assigns 16384 to the variable X. 
This assigns 2584 to the variable Y. ' 
This pokes a 4 in RAM location -3 (65533). 



■• *mrY-- 

i -il^-'f- - . - 

. y2#y . 

T:V#Y'Y* 

i .'. -i ■ * 

, . .-* .*, * t * 

Y:: 



I ■?';,*> Y •■»"-'• ■ 



CMD"C' 



Space compression. 
CMD ,, C"<ENTER> 



This command, eliminates unnecessary spaces and linefeeds from the resident .-''/ ^ 
BASIC program, resulting in more memory and faster execution. ' v- . ■ 



■^m 



CMD"D" \ Y - Load and execute DEBUG. 
..,....- Y CM D " D "<ENTER> 
This command loads and executes DEBUG. (See library command DEBUG) 

CMD"E" Disk I/O error. 

.-. :/ cmd"e m <:enter> 

This command displays the last disk I/O error occurring in BASIC. 

CMD M K" ' •. Zero numeric array. Null string array. 
CMD"K"w(0[,0...]) 






■,YY : - V 
,,; Y'Y" ; 




N '-v*;tv.--.V !_'■ 

' jY' : f* \ : ; 



J 



:->v Y 



.YY " . w = Any valid variable name 

Y ; r "'''-■...' * dummy argument ,. ., 

YY This command zeroes the array w(diin[ ,dira. . . ] ) . . "... 

\'f\ EXAMPLE: \]\ : ' . ' '' v •'• ■;,"'. :;. 

.•:'.. .,. (1) 100 DIM A%(6,7,4) "" ' 

... 

690 More program lines . 

700 CMD "K" A%(0,0,0) ... 

710 More program lines . . .-v 

A% is dimensioned to a 280 element array. After line 700 is executed, A% is 
still a 280 element array, but each element has the value of zero. 
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:<4>£Y 

1 -f Y 









^ '."■«*■ 



^*V^?v^ ^C;; ; :'■ v.^ ^^-.; : V ' " v '. SUPERBASIC 
.^ CMD"L" ■;■;. V Delete array. ""-' 

CMD M L"vv(0[,0...]) 



:<■■>.. 



uf-T : : ~ w = Any valid variable name 

*''..■/'.•.-'•"' - » dummy argument 

This command deletes the array vv(dim[di>a. , . ] . After using this command the "••' 

array can be redimensioned. ''i-"^4 

EXAMPLE:'" : -'••.■.'. ••.••.'• ■ ' ..-=*"• \;- : ' '-.-,. '.',.;.-, .. , ., .. ^fe», 

/-."-.-.• • ... • "••"!'.:• •■' ' • •'•''• ; 'ttsr*^ 

" ,; : -, ;"". " 100 DIM A%(6,7,4) " V V ^V . .'J !''•„/. -. '.,..'[ • ^ .'. :^t^$ 

■ ' . 110 More program lines -' "' . • * ' ' ' • ;.■' ..":•• ■■:•. ^wt'.j 

';••:""..■.■ • '• ~ i " •"• • ..- : '••' •: : " ' '- . •' '•' .•• . • . - . . ; -"---"f*J 

-'-'••• • ' : '- ' v: ,",«,' 

":':" 690 More program lines . "- ,,• ■ *-i >'£'■■ 

}.-;•" 700 CMD "L" A%(0,0,0) . ' • ".- ■ '..r:':^k 

"v" : ' 710 More program lines . ' ''•''• ' * • .. . _•;..' : £;: r$Kj 

AX is dimensioned to a 280 element array. After line 700 is executed, the . v ~/-V»'-VSsMsfr 

array A% no longer exists and memory consumed by the array is available. .... .fcj>'?y^%j&£'' 

$£*-•-«»:"-;-*>:/ '•«'.-.'."• :'■■-:■'*'.[*■: '■■-i. W. '.;".'... . '- ■. ■->■•.. :.;,. ;,.. ».. . \„ • .. ..* ' ' . - : -- •• T ■' l^\'''V , '/''^&i i 



. CMD"P" , Pack program lines 
>k --.'•:' ' CMD"P'*<ENTER> . 



•"-'V.?^:*' • " 'Maximum line length 



•*■•"" CMD"0" ' -.,. ; - : "■■ '■ String sort. (See CMD"Q") •:. ,- ■: -Vv^\>\^< 






_i{ This command packs BASIC program lines together and maintains program A' 

-logic. Upon invoking the command the prompt: .•' '. S 



A^will appear. Enter the maximum number of characters to be packed into one ' 

;V^ prog ram line. Enter any value between and 65535. A packs lines to a 1 • . 7 . '■.'> 

1^'maximum of 65536 characters. The default value is 240. After the line " . -' '"",*'%. 

'£■&. length is selected, a second prompt will appear: ': : i^'^ t -- 

''/?&££!?..*.; /-'-&:: ZL, .-■.•'.:■.■ ■ '-. ..... =■ ■ . • .*'■ .• - : ■ '•, .«) '*&** ^/;fCX 

••-li^-V-:--.- ; "' "VI rat " - • '" " ~ ""'."' .■'••'-."■ '.;•••" . *•;•&'? ~ 

.S'-iu,^ Enter the first line to be packed. The default line is the first program .• ., ,"," ,;.2J!' 

v'3?;-; line. The final prompt will then appear: • ' -• ';•»- . . " . • - . , . .. ■,;->■ ■':'■,.■ '.H-'tv/.s 

^^.'•"v'r'.^'.v,-. • '.•-:■■'-'; ..--'• • - . , '•'; .-;..■ ' .-^ '.",..-• :'.••'.','.: •••' s.-''--:";,;".-'?.' •.•V'* t^i^" 

4i/^ ; \' - . .. Last _ .•.'•.- : . • '■• /, :- ••■• • "•'.■'.•y^^y'^-y : >:&S::y\t^^^ 

■••■££?<$?'''•■'' ■ i r . ; :'-' - • ' •■ " • • '•■^^<. ? ;-:v;' ; ^.?:-":».:-;-.- . i -■---,.>,.,.. v^?:^;/ 

'^■iT Enter the last to be packed. The default line is the last program line. . '' ' Vr - : -- : -. 'X£& 

a'v^i^-i-." ' ■'"■' •-■•'•■ 



\"X-V.if no errors occur, "the program will be packed using the following rules: ':•;'•.- $#;' 

—.'t^V-". • ■ ■ . - ■ . . . ° . . ■■4'.-. • . .•»<»." 

J^;'. ^ ines referenced by other program lines are not packed to a previous line. ••--" 
.'/£.'»» .'Lines with a REM or an IF statement are not packed to the following line. 

7>^»fe'::-": •'•-'. " ■ • - ' ' ■ •■••'■" .'•"■-../■■ - '. •. .'.;;.' 

-. rji"?^*- ;";-.:'. ■" ■' ' ; ' -' ' . ' • ..... --;■•■- • - • •'..•••. ••: ..-"•":' 

".fc^Page 84 .''. ', •" ••. '; : . "\ •'";•:•■ - '..; ■..■'■ ";" ; ; V--7'H'- ■ ' ; J- ■ 

•^ . A*?t:"-' .'•"•• ••.•'•. • • '■.'.'"''!■, ' '■'.'' • ■■'■-".•.: " 


















J 






: , SUPERBASIC 

CMD"Q M String sort. 

(1) . CMD"Q M ,nl,vv$(0) 

(2) CMD"Q",nl,vv$(0,0),n2 



J • ,J. . vv$ = Any valid array variable name 

J ■/., . • _ nl * An integer or integer variable representing 

• ." 7 the number of elements to be sorted. 

. --'. n2 = A positive integer or integer variable 

. .^; t . " representing the column number to sort in a ;..- 

J . '■':, . two dimensional array. ."•'■•-■ • :i'^ 

! \->'\ This command sorts of a string array in accordance with the sign of nl. If ;;. 
i :V;"'.. •• "~ nl is positive, the sort will be in ascending or alphabetical order. If nl 

-i • :/i is negative, the sort will be in descending or reverse alphabetical order. ' 

. • vV . VERSION (1) is used to sort a single dimensioned array. The array will be ' 

'.;:"/ sorted up to the ulth element, Including the Oth element. Version (2) is 

!•'■• used to sort a two dimensional array with n2 indicating which column of the ■ "• 

: i\... array to use as the sort key. ... ;■'"' 

• '.:'■**&'''-''.'. • ' EXAMPLE: . • r7- v 7 v ' ' ' -'V;''- " • ■/ : .. -.• r " v ^^ 

T '"'v"; ."..••••- : - ' -.■•,,..;.-.., .... .. __ • .. //:?. :;;» ; 4fe -* 

y .,:•••. -..• 20 CLEAR 600: DIM A$(10) . . ' / 

•:v Y -40 FOR I = 1 TO 10: READ A$(I): NEXT I '' "" 

-"• 50 DATA "WASHINGTON", "OREGON", "CALIFORNIA", "NEVADA", "IDAHO", 

I .■■" "UTAH", "ARIZONA", "MONTANA", "WYOMING", "COLORADO" 

1 .60 CMD"Q",I,A$(0) 

^X 80 FOR 1=1 TO 10: PRINT A$(I),: NEXT I 

I The printout will be: 



J 



'fir- 



ARIZONA 


CALIFORNIA 


COLORADO 


IDAHO 


MONTANA 


NEVADA 


OREGON 


UTAH 


WASHINGTON 


WYOMING 







NOTE the following key points. 

1. The Oth element was not used (it is a null string). : /v 

2. The value of I In line 60 is actually 11. CMD"Q" will not cause an error'"// 
if the value of nl is greater than the first dimension of the array. , ■■'■■■ >'\ 

3. If line 60 were changed to: CMD"Q" , -I ,A$(0) the printout would be: *•;>:• 



J ; ' WASHINGTON UTAH OREGON NEVADA 

. ! vx' v ' ••' ' '.': MONTANA IDAHO COLORADO CALIFORNIA 

- V;,-. •' ":.'"" " : " ARIZONA ... 
1-* :.*.-."''''*";*•■." : " ■•■•">•'"'' ' 
J .-.;.' •• What happened to "WYOMING"? A$(0)="WY0MING" and A$(10) = "". 

';':;' . ■-. *• If line 60 were changed to: CMD"Q" ,6, A$(0) the printout would be: 



; i S-:^' • 



:>*n 



J 



CALIFORNIA IDAHO - NEVADA OREGON 

UTAH WASHINGTON ARIZONA MONTANA 

WYOMING COLORADO 



° n *y s the elements A$(0) through A$(6) were sorted, leaving A$(7) through 
\ A$(10) as loaded from the data statement. 

L 



); 
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"■;."' '**■.. ' SUPERBASIC _^~ 

CMD"R" Enable interrupts (MODEL L only). y 

CMD"R"<ENTER> 
This command enables the interrupts. 
QCMD"S" Return to MULTIDOS. " 

CMD M S"<ENTER> 
This command returns you to the MULTIDOS operating system. ; 



CMD"T" . Disable interrupts (MODEL t only). 
CMD"T"<ENTER> 

This command disables the interrupts. This command is invoked automatically 
when CLOAD, CSAVE, or SYSTEM is entered in the command mode. Other cassette 
operations such as INPUT// -1- and PR1NT//-1, MUST be preceded by this command. 

CMD'^" " Unpack program lines. 

■"V *"• CMD"U"<ENTER> 

This function unpacks a program into as many single statements as possible, 
inserts spaces around each key word, and renumbers the program 10, 20, etc. 

CMD"V" , Scalar variables. 

-; : /". . CMD"V"<ENTER> 

" =>"*"' ' ' ' 

This command displays all assigned scalar variables and string equivalents 

:•<■•.. iri the order they were created. The screen will clear and up to 12 

■v.' '^, variables will be displayed. Press any key to display an additional 

-•■^variable or <ENTER> to display up to 12 more. This function may be embed in 

'■'C5. BASIC P r °8 ram » however, user intervention will be required to continue. 

-■•'!/"- CMD M W" Transfer to LEVEL II. 

V^fJ'-. : -CMD"W"<ENTER> 

.;.:;>; This function transfers the resident BASIC program to LEVEL II BASIC while 
.'^retaining memory protection. Refer to "BASIC #" for direction on re-entry 
•• fi to SUPERBASIC from LEVEL II BASIC. 

.-This function can be very useful if you want to work on a program which 
. '".'will normally be run in a LEVEL II environment. You can develop the program 
In SUPERBASIC, test it in LEVEL II, and return to SUPERBASIC. 
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J : , *S / .^-V:.-.Ay/S- .■•*>•::.::; ,r.-- ■»*>■? ■<■':■<■ ^..'. - -;,* V. 

3 



A N?:;v;- :"-7- ; \:': v ' "' superbasic 

„'.*"A*.; ••..«, CMD"X" Remove RF.Mark sta cements 



1/ 



- . This command removes REMark statements from a BASIC program in RAM. If a 
line consists of only a remark statement, then the entire line will be 
removed. After the remark statements are removed, the renumber function is 
cv called to check for undefined lines. 



if''- 



., v 



> 



v;7 •■;." CMD"uuuuu** Execute a MULTinOS function from SUPERBASIC. - v '. 

SC- ' •'■ .• '• •„" CMD"uuuuu"<ENTER> -.-.'. ''.' 

Sri.':- '• . • uuuuu = Any valid MULT I DOS command " ** "• 

'•y'_;':"'. v ,'. .... This command executes any valid MULTIDOS command, including BASIC, from '..■•■'■' 
v-f;-> " ■ within the SUPERBASIC environment. The command can be used in the direct : '.."-\v 
mode or as a statement within a BASIC program. The CMD"uuuuu" function will 
temporarily set TOPMEM to a value to protect the BASIC program, and ' '; '■ .V 
'.'. ,: : ? ' requires approximately 6300 free bytes to execute. ..-■--.■ v; J 



EXAMPLES: 






• (1). CMD"DIR" ' . '^'l ?*{?'&? 

The directory contents will be displayed. . ;-. ; ' 

(2) CMD" BACKUP": GOTO 230 ;.•"' " ' 
BACKUP/CMD will be loaded and executed. Upon completion, 

■ they BASIC program will resume execution at the next instruction. •'-.'.: 

DEF FN Define function. {The space between DEF and FN is optional} . •*. • 

.;' - DEFFNxxx(uuu[ ,uuu. . . ] )=www : '. : \ '''"■.• r 

■':.'■ xxx = Name of the function (any valid variable name). . ' '-• i -'w : Aj','. , />; 

uuu = Variables to be used to define the function. .' -^ V : 5v 

• > www = An expression or formula Involving the variables uuu. >yA'c>V; 






This statement creates an Implicit function. After a function has been «.-r £-y\. 
defined, the function can be used as any of the other Intrinsic functions, ; V£y\ 
e.g., ATN, COS, ASC, etc. The type of value returned will be the same as -':>/•■ 
the type of variable used to name the function. In addition, the variables ;Vv r 'J ; 
used in the DEFFN statement, are local variables and do not effect the ; V^(-\ : 
variables used elsewhere in the program. « •■•'■;• -f *?';&*)'.* 

. . , -• ' ' ' ■•■■ ■ /; - : ;>v^v 

EXAMPLE: ■ • • ■ :- .. : '^: v r ^i.;>' ! 

•_„.".' • '■■■'.-. y;,'2; till: 

10 DEF FN Q(K,L) = K/10 + L/20 - ^ / -V^^l 

20 INPUT "Enter quantity of nickels and dimes";N,D \':'*'.'< 

30 PRINT "The amount in dollars ls";FN Q (D,N) • . "" 
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•-"' •••«<; -. "••". SUPERBASIC 

The function Q (FN Q) is defined using K and L, but the variables in line 
20 and 30 are N and D. K and L may be used in the program and have no 
effect on FN Q, nor does FN Q definition using K and L have any effect on 
the variables K and L. 

DEFUSR Define entry address of USK routine. 

DEFUSRn = aaaaa . " 

' •'- n = The digit 0-9. If n is omitted is used. 

aaaaa = The entry address to a machine language routine. 
.:. aaaaa may be any numerical expression, including 
....••_ constants, variables, or functions. 

:'_ EXAMPLE: 

10 CLEAR 500: DEFINT A-Z 
" - ■• 20 N = 8000 

\ •••• • ; 30 DEFUSR 5 - N * 4 

...Defines 32000 decimal to as the entry point to a USR 5 call. 

"• INSTR "String search. 

• y. -"'.';•>; INSTR( [ p , ] s tr ing , subs t r i ag ) 

p =» An optional search starting position in string (default 1). 
string./* The name of the string to be searched, 
substring *» (1) The name of the substring for which you are searching, 
-• . or (2) The actual substring for which you are searching 

l.This function searches through "string" to see if it contains "substring". 
v If it contains "substring", INSTR returns the starting position of 
•Vv'substring" in "string"; otherwise zero is returned. If "substring" is a 
^/null string, INSTR returns zero. 

..'^EXAMPLES (let Z$="SUPERBASIC" , W$="" {null}, X$="SUPER") 

.v^lExpression Result 
T. V^M^. ... .... 

'.lONSTR (Z$,"PER") 3 

"vy INSTR (Z$,"TRS") - 

>£ INSTR (2,Z$,W$) . {W$ is null} 

.?;• -INSTR (3,Z$,"U") 

.v~\ INSTR (Z$,X$) 1 

?;:- INSTR (2,Z$,X$) 

',' INSTR (4, Z$, "BASIC") 6 

\.,. INSTR (3,"ABCDABCDABCDABCD","ABC") 5 
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SUPERBASIC 



1 
1 
1 



■ : '^\'j<iv}?:&\'>[y. LI NEINPUT c ; .. Input a string from keyboard. s '?')?■& 

.•;•"••■■'"-.; ..•••,-'" , t*V>'"". v ..'- 1 .:.-'-v.'%' "' •• •' ....■:■ ' ♦ '-t':'- ; .• " 



LINEINPUTf "message"; ]vv$ 

':&**;'••: : . ;? .' : v"t ;: ""•- • • messa 8 e °A prompting message 
••':'?$r'0:-'. • •"V: J!?" ■ : <;" : -'"'. •:'":•" W$ = A valid variable name 



5.. 



*.'* :- -- 3l!iiL!^ SI ? ? t 2J eme ? t ls the met ^ od to in P ut a complete line from the' 
tV v :. v 'v^ KeyDoara, Including leading spaces, punctuation, and line feeds. This 
:^: ■.-'••■--• •. statement nulls the variable, and does not print a question mark. A space 



'' l '5?.-V 



;«'- >. 



^ '■■'■?■ ■ r • '. : - is P ermit ted between LINE and INPUT (LINE INPUT). 






!■ ;jg-, - >,■ LIS!' ; ■ Dlsplay program text/ (Model r enhancement) 

vi'-.'AiSjr^ -/..-.■ ••''•■";.. .::•.;*•-.• LIST<ENTER> . ':.- ; '■• • ^ V : - ; ■• :.' -. :; V V- ,:•';';:'•'■ '^ ' ,f " i " '\' -^-- */"-•.•*'• ''••jV>>^.-:V'* 



1 






] 



..i.~ ,--.,- .-•-,-.• This command has been modified to show graphic characters included in 
^^f!f:'V\^- V: - JJ ^?,,^^* Editing graphic lines will maintain the graphics, as long as',:" 
<$£'ii;' t j+.r-f-te-i- ^ e „ A , comm aiid is not used. (If you accidentally enter an "A" command, use • V 



I ';^-(^^:"'^^V:V, .. the : ....'Q" command to abort.) 






: y^fe :; .;-. "; r ; , MID$- ■ ,• : .' Replace portion of a string. >•. '•'; '. / •; i 

."X -'V'" ' ■;' ■'.;:' :••' ; , : -'.'yv$ = The variable string to be changed. • 

t J ._..;•'•'■ ■■^••V-':f.:'.-.,. : P = The starting position within the string for the replacement. 

J --,;•/ ':':.*: ' . c ~ An optional parameter indicating the number of characters 

. vr.fjy, '■ ■"•■ •■:'■;.•• " ..•.■'.■ ' ' to be replaced. - , ., . .. , .-' • 

•;>7f-;.-.v.-' ■: :' ... . rr$ - The replacement string. . • , ' 



•'■■? .*.' 



;► \k'.t.-~-> 



. , ' . - 1 ' V 



I ■.'■■rr>V ! .--«' l - v ! : . ,v, :. : ^i 3 , statem fnt changes part of a string. The length of the target string'-*^ 
.■■S^W^r""i;----v.-v- ^ 1 ! n °t changed by the MID$ = statement. Excess characters to the right -^ 

r^,??::-.v; i: .vV of rr$ wl H,be ignored if rr$ is longer than w$. . ..•-,.•:. * 7*1* >■}■■ 

1 ^'^'Al-Vi^Ai;. EXAMPLES: (let C$="12345678", D$="BASIC") V' ' V ' V <;0 , ; .- = ,- .T^.p,^ 

•*r»X N ^ X^>iX- : i,' ,-.-'.'•""•: • -- fi'.--.^.".-'. . •' ■••, •.-•-•.: >•.-.!.;,' ;;,' . :,. •«• "-;.- • . •• • - '• - ... . ■..•.■• f> "., - >/. \ ■'.•!'*> ■ .■ ] 



Resultant C$ - ..'-;•'/ ^jT^r •-•" 

J_ '■■•'. • - -:-.\ :, ■, .V •v^^ ?:•» 

12ABCD78 . -.:' ...'•'•.; ^ ■■ '/^S;^.'/: 
BA345678 ■■•."■• .-'^ v •; -■ X >:$;*:&$ 
1234567Z • ' •■;/, r:' : ^:\:\^A: j y^ 

- " , ;'-. '"'"Ml'V'l.V f *l 

.. • ; " - z \ .1,! i >. _ . .»-. 

• . ..•;.-.'■;..■••. ,..,^ , /.>V^-i , -*'-.» 



* .^W#M^^- EXAMPLES: (let C$="12345678", D$="BASIC") 

J : &^t^<M^'Ar-- Ex P ressi °n. i;:i'( '.>;: '•'• V : Resu 
-^&^i>-ft^ MID$(C$,3,4)= ,, ABCDE" ~-— — — ; -- 

^^^t^SS^ MID$(C$,1,2)=D$ ■: 

•^••1 y^fes:^?^.-' MID$ (C$, 8)="YZ" , -V. 
^^^^^U^V TIME$' ^'..uvV^^ Get current RAM date and time. 

r^3?fe/ : '. : '' ^ r - ■■ • -' : : t$ 1 =^time$' '•••• ' • •■''•';''. •"• -...'' ■ 

^?r^ ; l-' ; '""' ' T J l±s is a BASIC function which returns, in a 17 byte string, the time ' and '•• 'V" 
I ''<»$3j&^-r - date in the form MM/DD/YY HH:MM:SS . :•; Jw 

■ ^i' v '{?.•.' -• r - - . ■ -* - ■•• ■ 

• 1 '-'ty:'. *•■".-;.* " 













■••/.: "•• 
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^^■^;> 



vxrr-.*" 




j'V USRn 

:8/*?5. .-• 



SUPERBASIC 

,-• •.';. .? Execute a machine code routine, 
USR[n](val) . '";; . ' ■ . • ; . 

n - A number from 0-9. The default value is 0. 
val « An integer expression with value from -32768 to +32767. 



■ •'■;.■,., This function transfers control to a machine language subroutine which was 
. :v previously defined with the DEFUSRn statement. When a USR function is 

v 8 .-. encountered in a statement, SUPERBASIC transfers the program counter (PC 
:>.;.;:■ register) to the address specified by the corresponding DEFUSR statement. 

■\. When the specified USR function is complete, via a RET or JP 0A9A 
^.'.instruction, the BASIC program will continue at the next statement 

v:'. following the USR function. ..•.,:• 



: "v » V' 

■ v.'- ■>* 
■-Ar. 



To pass a value to the USR function, execute a CALL 0A7F as the first 
instruction in the USR routine. This call will transfer the value of "val" 
to the HL register pair. To receive a value from the USR subroutine, place 
the value into the HL register pair, then exit via JP 0A9A. The \aV 
variable will contain this value when SUPERBASIC continues. ; , .; • ; ■-,--. 

The last USR statement executed has the LSB and the MSB entry points in 
A08EH [16526 dec] and 408F [16527 dec]. You can circumvent the extended USR 
function by poking C9H [201 dec], into RAM location 41A9H [16809 dec], and 
poke the subroutine's address into 16526 and 16527 decimal to execute a 
LEVEL II program with USR calls in SUPERBASIC. Add the instruction: POKE 
16809, 201 prior to executing the USR subroutine. This modification will 
enable SUPERBASIC to execute a USR function developed for LEVEL II. 



■&.' SUPERBASIC OVERLAY FUNCTIONS 



'■ •:■"..•.' i'/ '" ; Find ASCII characters. 
Ftar<ENTER>',. ■.';;':. ■].],'■?.. ,_ '•'., , 

^tV^This command will find all occurrences of " 
.ir-^V- display will indicate the line the "tar" i 
'^^occurrences are on this line 



j^FIND 



■hi •$ 



tar" in a BASIC program. The 

is found on, and if more than one 

"/" is printed followed by the number 



Vf&Xs. occurrences. Both leading nd trailing spaces are recognized. 

.^^^•^•.i/;..,::.-.- ,'.;/•;:.,.,, -••.,,. •• .. . : ., ;. .-....•;■■.,.-.•■,. 

■■**■■'<•& FXAMPT F.« - : •.•"---''■ ~. "•'•"' "-i" ••■'•-' 1 • ■■'.-■" •■'■•■' •' •:'.,••• :' ; ■: 



of 



y-^?^;,^s- 







<ENTER> --.V;.?^^;- 
10 20/5 50 70 90/3 



The ":", colon, character is in line 10 once, line 20 five times, line 50 



.^^jonce, line 70 once, and in line 90 three times. 
EXAMPLE: 









w 



F in <ENTER> 



:~[fr This will FIND all occurrences of " in 

. ^.:?, r ..' 1 / ■•. •. ..•'•. . . '. ; 
, r '"'•J-'page 90 " . , . . , . ; . .. : • 

'vfr*fe : ■■■■ > - ' • ■■ '- v ■ ' ■-' '■ ■ ' 



in the resident BASIC program. 



"-!»!w>£rv- ..•■', . 



V-V. ' 






•m,: 






'.•*:*• i " ■* ^-'V^^> ) ! 
•;..;•; ^■>-;'.'# : ^. i ll 

■■•-'■■ ' > »^ i h 
• •• ■•■■Xvic.:- [ 

- . r ; X^-^ < 

886 

V^;.-8" ; ->8v8^8c' ! 

i:^ij:.i' •;:••■-. ■. : ';-. , '-/" i 1 




/•8^- '8^8 f 

'"."'f''^ •*:-.-'v''* , »i:W'' ; -»"'^'. I 



V*.*', 



. J x ; 



) 



■" :'. SUPERBASIC 

GLOBAL EDITING Mass editing BASIC program. 

-<ENTER> {a minus sign fol Lowed by <ENTER>} 

GEDIT makes mass changes to a BASIC program, by performing the following: 

Change all or part of variable names. 

Change all or part of constants, data list items, or strLngs. 

Change graphic codes as "CHR$(x)" Into packed strings (x = 128-191). 

Change space corapressio codes as "CHR$(y)" into packed strings (y > 192). 

Merge adjacent line numbers into one long line. 

Split one long line into two shorter ones. 

Change key words. 

GEDIT - General changes 

-<ENTER> 
The screen will be cleared and the following propmt will be displayed: 
'L T . 

T = __' 

This is the target entry mode. The rules for the target will be discussed 
after the replacement is defined. After a target is entered, you will be 
prompted to enter Line A, which is the first line to search and has a 
default value of the first program line. The next prompt Is 'Line B', which 
Is the last line to be searched and has a default value of the last line in 
the program. Line A and Line B will limit a change to a specific range of 
program lines. The next prompt 'R =' is the replacement entry mode for the 
target specified. To re-enter an erroneous target, press <ENTER> for the 
replacement, and GEDIT will return to the target entry mode. To delete all 
occurrences of a target, use <SHIFT>@ as the replacement. 



T - A 
Line A 
R = H 
Use it? 



Line B 



Finally, GEDIT will prompt 'Use it?'. This the last chance to correct an 
error in the entries. An <N> response will put the GEDIT in the. replacement 
mode, an a <Y> response will start GEDIT to search the program for the 
target and make the changes. The screen will shew the line number being 
searched under the "L" and the last line number where a target was found 
under the "T". When GEDIT has made all of the changes, the total changes 
*-ill be displayed. To exit from GEDIT, at this point, press <BREAK>. 

If the replacement is larger than the target, the program will be increased 
in size by that difference for each occurence, If you run out of memory ,an 
"Out of MEM in XX" error message will be displayed, and all changes will be 
made up to the point (somewhere in line XX) where memory was insufficient. 



.-• j;r. 



y- 
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SUPERBASIC 
Rules for target: 

To change a constant, a variable name, or item in a data list which is not 
enclosed in quotes, respond with the item when the target is requested. 

(In all of the following examples, T is the target, R is the replacement, 
and "->" means changes to.) 

EXAMPLE: (Change all occurrences of the variable "B" to "F") 

T = B and R = F 

~"B->F, AB->AF, BA->FA, BB->FF, B$->F$, AB$->AF$, CA->CA 

To change only a single character variable, while leaving raulti character 
variables with the same letter unchanged, enclose the target single 
character within single quotes ('X'). 

EXAMPLE: (Change all occurrences of a single "A" to "G") 

T = 'A' and R = G. 

A//->G//, A$->G$, A$(1)->G$(1), A!(A)->G!(G), A%( AA) ->G%(AA) 

To change only the first character of a multi character variable, enter the 
target character followed by a single quote (X'). 

EXAMPLE: (Change all occurrences of the first "A" to "H") 

T = A' and R = H 

/A->I1A, AB->HB, AC->HC, QD->QD, AE->IIE, AA$->HA$, BA$ ->BA$ 

To change the second or greater character of a multi character variable, 
. while leaving the first character unchanged, precede the target character 
with a single quote ("X). 

. EXAMPLE: (Change all occurrences of the second "A" to "I") 

f T = 'A and R = I 

:**." 

j AA!->AI!, BA->BI, AA$->AI$, A$(AA) ->A$ (AI) , A->A, AX->AX 

..To change a target which is enclosed in quotation marks, precede the target 
-;".l wirh the $ sign. 
' .i .' 
:.,.EXAI.?L5: (Change all "E" in strings to "Z") 

%"..". T = $E, and R = Z. 

': _ "ABCDE" ->'7<BCDZ", TE ->TE 
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1 















.GEDIT - Changes to key words: /, y • • - V : ' ' ■ • • j 

.GEDIT can change key words, such as "PRINT" to "LPRINT". You must be 

"careful, however, as lowercase Is not acceptable. Under SUPERBASIC or LEVEL 

II BASIC, as each line Is entered or edited, it is processed through a 

, buffer* This buffer looks for key words and changes them to a one byte 

...code. It also converts all variables to uppercase. Since the GEDIT does not 

process changes through this buffer, do not use lowercase for key words or 

variables as a syntax error will occur at run time. If the target is'a key 

word or the arithmetic operators +, -, *, /, up arrow, >, =, or <, bracket 

this target with the "< & ">" characters, i.e. <+>. 

GEDIT - Building compressed strings - 

Program containg many "CHR$(x)+CHR$(x)" statements, will be shorten by 
building compressed string. To build a compressed graphics string In place 
of a CHR$(x) type lines, enter the "+" character for the target. To build a 
compressed string with space compression codes, enter the "*" character for 
the target. This results in faster execution and more free memory. As an 

129)+"X"+CHR$(176) 'V '■."• "' '•.■•■ : -./■'•• s j •-: W 
After GEDIT builds a compressed string, the 



^H^v 







.". represents a graphic character. The new length would be 14 
or more than a 50% saving of space. The CHR$(x) OR CHR$(y) cannot 
i_-.__t ., ., ., i>e ^ CHR$ ( 191 ^ is nQt accepta bi e 



line would be: 

[ W^ : ^ : ^k^^ a$=". .x.".: 

^-^:v*'i-^.-'.-' : ••">?;> - where the 

) -Sv^" ; ,-.^tiV;" bytes," o o _ 

.-•ft^ ^vv!'"'? "^j^i" contain blanks within the parentheses. 
i}-Lrj>V '■.-■.' i. ,~/-)3r> and will not be changed. : 

'fi^iS^,-.% , vS'.-^-'-- •.••- : ■". -. ...-•:•■-■•,.• "; vj.i , .. 
^S«t*5S;<Vi-\V--is;<AMPLES: ''•:' ' . " V ; =■•• '"*' y .-', Vy" y".' ' ". ; 

;^fei-V^l^'^:"'"(l) '.'*+" Changes 210 B$=CHR$(13l)+"X" 

> ^^^■•■M'TT^y : r -r ;-.': to 210 b$=-.x." 

vf@^&S^(2) -: "*" chi' : 



•;?vrt.J 



+CHR$(176) 



Where "."=graphicc. 



Changes 337 PRINT CHR$(204)+"TEST" 
• ■ 337 PRINT " . TEST' 




i" :- 


. ■*. 


.»^-iV: % 
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".'■'•' . 
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. f , 


' S - * V b*- • 






V- 


'• L\ **" ' 




.' ""' '" 








- f ■ 












•'».• 








f^. 




' i ^ 




r .( 




~ x V't 


> : .»<V; 


>.V 


1 • 


'/•: 




j. - 



. <-It 






r -^^* 



by the "*" 

400 A$=CHR$(178)+CHR$(204)+CHR$(190) ' • 

400 A$=". . ■; i u- v ." . . •-.••- v.. ... 

srging line numbers: - '".. •.''■..• v ■•/\:\ 

■>'r*::.v»*:V ,i ■•' '";j-?v>.'J r ;".* ;..'"•.' f /..;"; "'-^ '!•'.•'■''/''• ■'">■■ " "' ''* • ; ■' •> ' '•' "" -" ■"-- "' ; i -"' ' "\ ''•"-' "♦CfT^'V 

'i'^/i^. GEDIT, can append 'a program line to the preceding line in a program ,~ ^--V 

.:•.•. disregarding references to the line. As an example, if a program con K alrs '~. f 

.'.:. lines 1,2^,4, & 5, then you merge line 3 to line 2, an error would result . r-r 

' : •' atrun time If line 5 originally contained "G0T03", because line 3 no :,' : 

longer" exists. Do not append to a line which contains an open quote (10 '" 

A$="THIS IS). Close the quote first, then merge (10 A$="THIS IS"). '.;"■■■ 



'vv- ** > 
--•.''-S' ,, ''» • '-'• ' ' 
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"Vift, »' 



-£v ; ^£k> V : -^v;.^;- :; ' "'^ ■•••»:*>(- fc? ; -> : 1iv; . . SUPERBASIC' •.,.-, 



GEDIT's merge can create lines greater than 255 bytes in length, which will 
"execute properly, but can neither be properly listed on the screen nor 
edited. If necessary, use CMD"U" to seperate the line. To merge, respond 
with the "/" character and the line number to be merged as the target. 



V. EXAMPLE: ;..;.- • '••*.' • •>•. ,\\\ 

V v^ : ;\-.-' 10 A$="TEST //" . •.. 

.%.'■'• '''&> • - 20 PRINT A $ • '""" ' "■'.' . 

v " To merge the above two lines, the target is /20. The result is one line: 

; i~/J^'' •'.'-" 10 A$="TEST. //": PRINT A$'. ■ " ' ' [;'"[[;.. '.'" "._.',y . .,' '"' ... . " . • :^ ; ; : 

•••.-:' GEDIT -Splitting lines ". ' . '' ' 7^' :,i ': V '^ ■ "V^^f :r" : " : "'^/ 

' GEDIT will split a program line containing two or more BASIC instructions 

''•":''• ~ into two lines. The new line number can be any number greater than the line 

'-:"" to be split. However, if you assign a new line number greater than line 

r . r< number of the following line, run time errors will occur if the program has 

• a references to the in-between line. As an example, if a program contains 

vi— lines 10, 20, 30, 40, 50, & 60, and you split line 20 into lines 20 and 45, 

'.■ lines 30 and 40 will not be found by any reference instructions such as 

"GOTO 30", "G0SUB~40", etc. However, if the program flow Is such that BASIC 

•'would normally "process the next statement In RAM after the new lines 20 and 

• 45, lines 30 and 40 will be processed. BASIC would, in the absence of any 

branching instructions, process lines 20, 45, 30, 40, and 50 In that order. 

: 'The split point must be directly behind a colon (:) in the program line. To 

split a line, enter the target in the form -ttt, where ttt is the target 

for the split. If the target is a key word such as "PRINT", enclose the 

""'• target with "<" and ">" signs. If no target Is specified, the line will be 

-i : •" split at the first occurrence of a colon. Line A now represents the line 

-i'V -"number to be split and line B represents the new line number. . , ; 

^f^i^r'VlO A$="TEST //".-PRINT A$" ; , . , : . , .. * ; .['[. 
•^^Tol split" the above line, T = -, Line A = 10, Line B=15. The result x is: 

'■%^P^-"rr io" a$="test //" "■ •■' 1 ■' ; . •'.. .. ,; ;'■::::''; ;. ; . : ;.■■' 
■^%-:v^- :.•■.'.'.;. 15 PRINT A$ ,-...• ' ' 



•"-•^.>r.Si 



"f-> 



*ir*'.s. : -: EXAMPLE : '. ■ . ,' ' : 'yr.;/' \ .■■•■:.';' ■.. ''■-. ..,••'. , •';/;.,• .?..': ;:«..>. , .i ) . • •■■■■•.'.• 

'^^r. ■•.;'."'■ . 30 A$="ABCDE": PRINT A$ : B$="FGH" : PRINT B$ ' '•.: , '; : ' ^iVi- ;;,';' ; ' ' 
"iTl^-'-v -V • »■■'•'":■.■•; -• : . .. -. . - • ■■■ ,■•■•■ " ... ■ .;' ";.'. .'".-''■?.,■' " ; • • 

^|Eto V 'split the above line at ":PRINT B$", T = -<PRINT> B$, Line A - 30, AND 
.V-lr?"Line B = 35. The result is: .. J.. ; /; .'. ■ ■'■ ■• 



•V-" ; 






- '30 A$="ABCDE": PRINT A$ : B$="FGH" 
; 35 PRINT B$ 



■ '*;''■ 


:V*isV : r . : '- ■ ' 
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n,>ir.'. 
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SUPERBASIC 

REFERENCE Cross reference variables, and Integers up to 9999999. 

; [p][[//]xxx]<ENTER> 

p = listing directive. If p = "*" the reference listing is to 
the display. If p = "$" the the reference listing Is to 
the printer and the display. 
xxx - Reference target: 

(1) A one or two character variable name without 
a type suffix. 

(2) An integer number which may be a line number 
or a value used in the program. 

(3) A key word if preceded by a // symbol. 

Option (1) lists all line numbers which contain the variable specified. 
Option (2) lists all line numbers and other references to the integer 
specified. Option (3) lists all line numbers which contain the key word. 
After a reference target has been established, the reference lines will be 
displayed sequentially, with each additional press of <;> alone. 

If the p option is used with a xxx target, a reference listing will be 
produced starting with the target and proceeding in ascending order. Use of 
the p option without a xxx target, results in a reference listing of all 
integer numbers and variables. If the reference listing is requested in the 
form ";p*//<ENTER>", a listing of key words will be produced. The key word 
listing is produced in the order BASIC " tokenizes" (converts to compressed 
storage) the key words. This is not alphabetical order. 



To pause during a reference listing, 
press any key. To abort the reference 



press shift @. 
listing, press 



To resume 
<BREAK>. 



the listing, 



EXAMPLES: 



;*<ENTER> 

All Integer and variable references are displayed on the screen. 

;K<ENTER> 

All references to the variable "K" are displayed on the screen. 

; $G<ENTER> 

All variable starting with "G" and continuing through "ZZ" will 
have their references directed to the video and line printer. . 

; //PRINT<ENTER> 

All line numbers which contain the key word "PRINT" will 
be displayed on the screen. 

;$//<ENTER> 

All key words will have their references directed to the video and 
line printer. 



) 
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■■( '■ J . SUPERBASIC 

When a reference is displayed or printed for any target, the line number 
containing the reference is displayed and may be followed by one or more of 
the following modifiers: 

/n where n ■ the number of references to the target in the line. 
/$n the variable contains the string designator "$". 
/in the variable contains the Lnteger designator "%". 
/!n the variable contaLns the single -precision designator " ! " . 
/#n the variable contains the double-precision designator "//". 
• (n the variable is used as an array variable in this line. 

the "n" will not show if it has a value of 1. 

RENUMBER Renumber a BASIC program. .,. . 

V v ' : [nnn][,iii][,sss] [ ,eee] <ENTER> . , r 

nnn = The first line number to be assigned to a renumbered 
';';" "' . . . line, nnn has a default value of 10. 

"-' ; r Iii = The increment to be used in renumbering, iii must be 
■:/ •'"-'. "%'X "4 ~\- 'greater than 0, and has a default value of 10. T , . >. ,-.'•'.'. 
."*...", ".sss = The starting line number in the original program where 

r..,../ / '^' ^/renumbering is 'to start.: sss has a : default value of 0. . ; 
■\. ' .'.!"„ '.f^-l? 1 '' This is the first line renumbered. «■:..»,.; - 

' ^ eee = The ending line-number in. the original program where line 

renumbering is to stop* eee must.be >= sss and has a 
■ .. . , default value of 65529. This is the last line renumbered, 

RENUMBER checks for missing or invalid iine numbers in a program, recovers 
a "NEWED" program, and renumbers all or part of a program. To recover a' 
program immediately after a "NEW", key in :<ENTER>. 

Error checking only - for undefined lines, etc. - is accomplished by 
leaving out all arguments, e.g. :<ENTER>. 



•Error types are: 
k -V V lllll/nnnnn/U 






11111/S 
11111/0 






EXAMPLE: 



Line number 11111 has line nnnnn undefined. 

(line number nnnnn does not exist) 

Line number 11111 contains a syntax error. 

Line number 11111 contains an overflow line number. 

(line number > 65529) 



:^': 



, .. ,,. 20/290/U means line 20 has a reference to line 290 and there is no 
'?;"•«•■£" line numbered 290 in the resident BASIC program. The reference may be in 

,j;:;; v the form of (1) GOTO 290 (2) GOSUB 290 (3) ...THEN 290 (4) ELSE 290 

W\, .(5) RESUME 290 (6) ON n GOTO 280,290 (7) IF ERL - 290, etc. 

■ "* *, J>" . .V, M- . ,.- 



-.1;" 
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1 






1 ; *^^^7^^^ ••■•::•;.. SUPERBASIC ,. ^ \. , ■ . y . ._ _ .. . ^p.^;. 

""V^/ .r£f. '■;.'• ■* : . / >'.". RENUMBER will check your program for errors before renumbering. If any'.. 

errors are found they will be displayed and the program will be unchanged. ; ,. 



] 
] 
] 
f 



_)..*#;.••■:' 


*';/ !- ii 


*,•«&£ ■•• 


. ./ j 


••".•»>:■*■'». : ;/. : 








x Mi;:r- 


';•''/"• ^ 


: :r.if:{: ?:W 




• *•/,>■' V ; r: ."■" " 


•' % ''■ .•;*..» 


.-\>.a'^J> • t 


■ ' ~ 


-•.^.-^i-..- 


\ "■' * 


■ ' . »■»» • » * i 




•'•JS *.•!>.{' - 


J ' ' '* 


VAi'-':v ■ 


- W': 


' .■.♦ .■ • 


■;s* : '' 


■ •'.***•"". ' • ■ ' 




■''.-".«£#»*•» ' ;.* ' ■ . • 


• K ;•■• 



EXAMPLE: 



*&y 



10 PRINT "TEST" 

20 GOTO 290 • • v;,\'- " 

30 INPUT A " ''■•''•• 

40 ON A GOTO 10, 20,, 60, 70 

50 GOTO 10 

60 PRINT A "•'-.-• :••■.". '•-• ;.:/•■■'. : 

70 PRINT A*2 ' -:v; f • ;>•■ , 

80 GOTO 70000 . , /. • \> ,.• 

90 end .. v . ;;-'." '.""'' 



♦'SS*-*' *'" " .*:-'•".' An attempt to renumber this program, will produce: 

*$$&? M^!:^ . ' '••: /'. '20/290/u 4o/s 8o/o ;"->;• . 'V '.Li: 

• s*^K*'> : "/ ■- •• v."^'.-'.' '•.■'>":■: Function completed : .' : ;• ^ .- , 
^■^V-'v-'riP^V./.-.V}:^;^ READY V-; ...;■ : S •.•,:...'.= .•• . "- . '"•....'♦ 



.... 


•'■/V 


" r 




.'.'..<- «'. 




;» 


Ti 








-w' 










' v. 


" : r 


«# 


•'.'• 


r>'f: 


'^ 1 




J ■ 


"^ 2 


•► ; 


1 j- 














■■"' 


\ t 




» r > 












*»*v 




: "•"?•■ 


# 


.":Jj. 


r 



->•<:•. 



'ffi&^r-'tei^,:^^?:'. > 



I ^;vY ^a;^~ This _ 

J .':;^:V'/' %f- line ^ 

' ; J -".e-.-..'' .'.■..■ v ■ • 
" ..• >■*.*• ■".- - ' " •■ '*■.■ 

■ . I\. «• .•*■ ? -" '■.■'-■.■•■ ;'. • 

1 - -V-ii;^-- •..■•. I': 
>-i ; r^^> .■;:■;•;•;. 






tells us line 20 has a reference to line 290 which is <U>ndef Ined, 
line 40 has a <S>yntax error (the double comma between 20 and 60), and line 
80" has an <0>verflow line number (70000). After fixing the above errors, 
the command " :50,1,50,69<ENTEK>" would generate the following program: . *. 

^^•"^ ; 10 PRINT "TEST" ; . • ^ .'":> . \ •.•''■•' :- ;.■"•:.'. ' . - : . • ; .L 

.-••. v: 'V 20 GOTO 90 .. •"... •,/■': 
/.rW;- 30 INPUT A >• -• ••• .,'..., ..-/•.•■■ ■•. '- ■• . . ■"...' 



f ^@-" r ';:> ^'- •■ • ' V " 40 ON A GOTO 10,20,51,70 

J -«.:V> ;#.::-... :--..-,.?^ ■♦.- . '. •^..• , . 50 G0T0 10 






51 PRINT A 
70 PRINT A*2 
80 GOTO 10 

90 END t :.^ :-,... 




^^Wfe^^-^v^-'^^^V'^" ^^~:V^ 1] - INPUT A »■•■.•" •■•••s ■■*>., ■ >:. ^ . • . .;:-;•..;. •-..v^., '.a v.>'Vi-\ '•?•"• 

V^SS0^*^^^^>^V ; ^ 12 ON A GOTO 10,20,14,15 t •- • "".• -. ;-. '*■. . . . . :V- , r ^-^y.-'XWiW^ h' 

i^^^^^r:r^^ ; :i4 print a -;; : vm-v , ,-, . ,,..-• ;,/.,• ,: ; ..•/ .:..:.; ;■'^;^4^•r•:■r:r;:^fe?^■ 

?@^%^?^# ; ?^ PRINT A*2 : .'fS;:vi^: : .:X;'V./ -. v ••• • -. ,v, ,-. ;/,/-,. >; v. : ' : ;.: : - ^^^^irf "''' 



^^^v^##^.A^M^% : 15 PRINT A*2 " : : .^^;:vi,^: * ..:X^V./ ••"?:'"••'•'"• -."" .' '/>.■ ,;,' " ' ••V ? -.".' ^' ; ^ '^ '- : ' '''. : * / - : i \-'A'5^' 

^!^y.:.^;>,v-. ■' ■;•: 80 goto 10 . • , •■ .* - -.,..>...-^ .n 



90 END ';•; -.' ' ' : ''' '' '"V-i;" ' i, 't > .-' ,.:-r V ■ ■ ^r'.l^v^ 



] 



•r^i®^; • -". As long as newly generated line numbers, do not overlap the original text 

'•V-£V'I 'K- '.'•'■ H '•' ■'•? • lines, the new lines may be placed anywhere in text. 



't^v'-r.:.-,; .■::>'• • : ",■ • .•' : - ••• ' .• - ; ... : •^-•',.- ; ^';;';- ; :3V: 



j 



•J^v'Si.;-:,:..: ■••..•*•.••!•.,-. 
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SUPERBASIC FILE MANIPULATION 



SUPERBASIC 



;«>*.** 



KILL Delete a file from a diskette. 

' .;;• . KILLvar$ or KILL"f ilespec" 

var$ = a string defined as a fiLespec. 
. v , f ilespec = a file specification for an existing file. 

This command deletes a file from the directory. If the statement is within 
the program, the file should be closed first. If KILL is executed in the 
command mode, KILL will close all files before It attempts to remove the 
targel f ilespec. . >. 

LOAD '. Load a BASIC program to RAM. 

~V~' LOADvar$[,B] or LOAD"f ilespec" [ ,B] 

;?/'--..• var$ = a string defined as a f ilespec. - ' 

.^f;' f ilespec = a valid BASIC program file name. v. . , ; , 

This command loads a BASIC program from disk. The " ,B" option will load and 
run the program without closing any files opened via an OPEN statement. 



i 






•:V/-;wm 



■..;.'.,-*V,<^v;..A: 



MERGE 

.( i r-- 



-.' .• Combine two programs In RAM. 
MERGEvar$ or MERGE"f ilespec" • 



'*; -'?.:'" var$ = a string defined as a f ilespec 

,:';;\ .' f ilespec = a BASIC program saved using the ASCII option 

.'This command combines the program currently in RAM with the program lines 
;■ in var$. If a line number in var$ coincides with a line number in the 
■-."'resident program, the resident line will be overwritten. 

■VrNAME-; •V:.;:j'i 



,.&.-•■'.. Load an execute a program keeping variable values. ■■ ; .': ', ■•• '.'.' : V*A\i r 

,V^.^*'-~" "NAMEvar$[,B] or' NAME"f ilespec" [ ,B] '' -y. I'i';'"' ''" : '- ''-,"■•' '■■•■ ' ' ,":'.';■■ ':.']''': : ft '."; 

•.;.£, This command chains programs which are too large to fit In memory. This ... ■'' : '): : ?\%- h . '•■ • v "' 

'.Y-^ command load and execute the file var$ or f ilespec beginning with the .-.",.'.■ "S^v *'.*.'•. 

^.'[lowest line number as if it were a new BASIC program. The previous ' • i' ::; V- .■■•* , t ' r Sf'S- \\ 

•I- variables will remain intact, except for DEFFN, strings created via READ, , '.p ; '' '■"' •' '''•. : '^-k&''' i 

T.^. or string assignments directly in a BASIC program. The ",B" option will • .. • '• : -\*:V : v. ■ • •• . 

^..load and run the program without closing any files opened via an OPEN •."'"■.■"'. 4': J 

^'..'.statement. " ;. -■■.-.. .-'•* ;,'•',"■ \\''y-\':' <1 

• * t .**$} : ''.'.. ' . ' ' \'' V ' "" '. '•"•''"' ''■;' ' : '-'"vV"";' : - : ,:"^'--"'i/'. 1 ' 
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■ ^i.» * ."./•. 



•<;.&;-y 












Jj ?\. • ■■•■ . .-* r M ■ 



-^7. 



n^<vgr^^. : ^: : ; :;" ;- ^^v-;- ;•/ .' ^ superbasic 

"V— 7 v'_; * RUN Load a BASIC program and execute. 

"1 . '•■•.'.p^V '•""/•." RUNvar$[,B] or RUN"f ilespec" [ ,B] 



] 
1 



1 


..." \ *~ " 


1 


; ".V£v - 


] 


. ' • 




■) 


J 




1 


"■ '"i:T • ' ' ... 






1: 






j,. .-.--iv?- .-•.-•■ , 


I 




J 

■y. 


••'•/Fv'.'-"-''.- 


] 






►r--*.«T* 1. -'•*. 


1 


.*.,_»"< 7'"" -• 


J 




J 


•v^KfW-:! 




i\>'- '*'. 



This command loads a BASIC program from disk and immediately executes the 
program at the lowest program line. The ",B" option will load and run the 
program without closing any files opened via an OPEN statement. 

'** .'»«.■-. 
SAVE Save a BASIC program to disk. 

SAVEvar$[,A] or SAVE"f ilespec" [ ,A] \ .•■£•.;'; 

A = save in ASCII ." ~ > 

This command transfers the current BASIC program to the diskette. -\v-*/;V' 

SUPERBASIC FILE ACCESS •••V-'.vr.^ 

.: • . ' ' ' '.""''" "*"•?" '•"%T^*-.* 

• "• • "" •-••••■*"'.' A>V *"', 

OPEN '• Set the mode and assign a file buffer area to a filespec. .-XI v.:,* 
- . - irr F? *' 

' " '" OPEN mode, buf, var$ . '. "■■'« *' ■ -j ./ v.?0*# 

■■■"•■■ .* '.-<. 

. '* mode is a string or constant, and is one of the following: ."'.'" ■;.-.< 
• 7 - ' mode access mode ' '.." .-' r , 

D RANDOM I/O to an existing file. 

E [EXTEND] SEQUENTIAL OUTPUT to a file. 

I SEQUENTIAL INPUT from an existing file. 

[OVERWRITE] SEQUENTIAL OUTPUT to a file. 

R RANDOM I/O to a file. 

; :: buf = the file buffer area, in the range of 1 to "ff", to be . 
assigned to var$" . "ff" is the number of file buffer areas ". t 
made available during BASIC initialization. Only the "I" mode 
can have more than 1 file buffer area assiged to a filespec* *•• V 

- • var$ = a string defined as a filespec. . "'' "*"'' 

v ° r . .', . . - •. • / r- •> " ' • ' y 

OPEN mode, buf, var$ , udl * • • • : ">; "• 

• • • 'V-. ;: '?$ '> 

udl = user defined record length. .^v ; ^ 

Mode can be "R" or "D". If mode = "D", udl is obtained from the filespec. \ ," 

■ • '•' '• ' . •■•'■'••",.■ % ■"■'• V''-* 1 ■«*■■ 
EXAMPLE: let N = 2, Q$ = "IOTA", P$ = "CHECKING/TXT". ' : >0- !^Mv! 

•':'*■ openq$,n,p$ ' r :'"-.' : '-(v* -\ 

■':".'.; • " •.■•-. ••.•..'•''•."''rVi U 

Opens the file "CHECKING/TXT" for sequential input in file buffer area 2. :•-•*:,' 

OPEN"0", 3, "BALANCE/TXT" : 

Opens the file "BALANCE /TXT", and assigns file buffer area 3 to the file. -•■*'■ 
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CLOSE Unasslgn a file buffer area by buffer number. 

.-.•r.V: CLOSE[//][buf[,buf...]] 

';•' buf = an expression with a value of 1 to 15. If buf is oralted, all 
• : . • • open file buffer areas will be closed. 

'' EXAMPLE: .- 

V^';\ CLOSE // 3 Close file buffer area 3. 

- : " CLOSE 8,2,4 Close file buffer areas 2, 4, and 8. 

•---; CLOSE T Close file buffer area equal to the value of "T". 

.'•'•' Any statement or command generating a CLEAR will close all files. For 
"■ ■- example the following will close all files: NEW, LOAD/RUN (without ",R"), 
■;:"■'■■" MERGE, DELETE, EDIT, and CLEAR. 

- r INPUTS OPEN"I" read data command. 

>/,'° :Jv s .INPUT// buf ,var[ ,var...] . : : ... -. ' 

•.,;.•.*'-■■:'. : ... . bu ^ = file buffer area 1 to 15. \ 

,."'' ■"'•."""" '' var = a variable name to contain the data from the file. 

. This statement inputs data from a disk file. Each data item is read 

' sequentially from the beginning of the file. To INPUT// data sucessfully, 

you need to know how the data was placed on the disk. If the data is going 

to a variable, BASIC ignores leading spaces, and begins the INPUT// with the 

'first non-space character. If the data is going to a numeric variable, a 

comma, trailing space or <ENTER> in the file will terminate the variable 

assignment. If the data is going to a string variable, a comma (not 

\\ enclosed in quotes), or <ENTER> (not preceded with a line feed) will 

;'/-* terminate the input assignmen after the first non -space is encountered. If 

-5" 'non-quoted text is encountered, followed by quoted text, then the qouted 

; : -.f text also becomes part of the variable assignment. 

■". ''-;*:: LINEINPUT0 OPEN"I" read a line of text command. 

'.i^fe^s--- /■•-•■ --■. 

;;r^;-%VV, •■■- LINEINPUT//buf ,var$ 

.'■V'-i^-.i.';" . . . 

. ,: v-^fJ^.V. . buf = file buffer area 1 to 15. 

V^Hv^.vsr .': :• • var$ = the variable name to contain the string. 

: "J^LINEINPUT# " will read all characters from the current position up to and 

the end of 
differs from 
terminator. 
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] 



.v^vsX ^:i^^- : &.£'<■'. '.v.'.'. 



l^W 



: x ~^?0y'.j-- ;V/V 'y- SUPERBASIC 

\ ~\ r ■>>,., PRINTS OPEN"0" and OPEN"E" write statement. 



1 
1 
1 



PRINT//buf [USINGforraat$;]itera[m item...] 

buf = a file buffer area 1 to 15. 
format - a sequence of field specifiers used with USING. 

m » a delimiter placed between "items . ...... 

item = an express on to be evaluated and written to the diskette. 

T , fl HpUnd ter "m" can be a semi -colon ";" or comma V*. The use of these 
Pln.it swl determine the format on the diskette. If the comma is used 
the "1 ems" will be zoned in 16 byte areas on the diskette, just as a PRINT 
statement's the data on the display. If the data 1b string data with 
punctuation, then the delimiter should be ;CHR$(34),. - _ 



EXAMPLE: 



1 






) 



1 



X$ = "JONES, TOM'** \ . 

.- . - Y$ =• "SMITH, PAUL" ' ... . • : V 

'. , .. :'•-:• ■;'.'/•[ PRINT//2, CHR$(34);X$;CHR$(34);Y$;CHR$(34) ..." /. ■■■^tyl 

' FIELD " ; -.';\ OPEN"D" and OPEN"R" file buffer area organizer. .;•;•;.: 

: FIELD [//] buf ,lenl AS strl$[,len2 AS str2$...] T, . 

buf - a file buffer area 1 to 15. ' : 

lenl = the length of the first field. 

str$l = the variable name of the first field. 

Ien2 = the length of the second field. 

..-'. Qtr$2 = the variable name of the second field. 

■:-;!?. - subsequent "len AS str$" pairs for the balance of the buffer , 
area size. The size is determined by the user for created 
..,/•>' * ,; :. files or by the file itself for existing files. 

.''■'.;'* V More 'than' one set of . variables can point to the same buffer area. V^tW 

'..'.- ,"' ',']''"/[ EXAMPLE: v '"'.' '• ' •• '• ' - -.-^\jp- }■■"'' 

The data is stored in the following format. The first 64 bytes contain the Y;. 
; : : - ; ; client name and address. The next 14 bytes contain the phone number. . ., ^., . 

V\'fV." ;: v r -'r>'-:'-. ! . '/J. : ^:^'fIELD 1, 56 AS AD$ '' . :: ^y.Z^.i 

•/•: :•...• .■'.•;■• ",->r:- ; .U;:: field i, 78 as ap$, 122 as hg$ - •• ' .'^.. ;'i:.':>^j. 

• ;V '" '"•'■' '"•."' Thesl statements' assigns the first 56 bytes to AD$, the first 78 bytes to ^ 

•.-••I.:*: V V AP$, and bytes 79 thru 200 to HG$. Printing AD$ would print the clients , 

•":•-■ ' ' : -' • name but not the phone number. However, printing AP$ would print the phone- , 

r " - •- number as well as the address. The first field statement could be , - • 



■■>&! 

.>'*•:' 



y l 



FIELD 1, 56 AS AD$, 14 AS PN$ 
to capture the phone number. 

' Page 101 






'.•:-V.> : - ;> ' ; "'• - '"* • '■:?<''"*'■'- SUPERBASIC 

MKI$, MKS$, and MKD$ Data converters. Numbers to string. 

Since all of the data items for RANDOM I/O are defined as strings, numeric 
data must be converted to strings. 

MKI$(num) ' nura is an INTEGER number only. 

MKS$(mim) nura is a SINGLE PRECISION or INTEGER number. 

MKD$(nura) num is a DOUBLE, SINGLE PRECISION, or INTEGER number. 

The length of the string is determined by the precision of the convert 
function. MKI$ creates a 2 byte string, MKS$ creates a 4 byte string, and 
MKD$ creates an 8 byte string. 

EXAMPLE: • ' '' " ' : •• ' ■■•...'. , • \; -.-- 

RSET PAY$ = MKI$(K%) 

• This statement will change the variable type flag from integer to string In 
the variable PAY$, creating a 2 byte string. " . 

-:•«■;- • LSET TAX$ = MKD$(K%*10) . , ,. . . - • ' ' 'j. 

This statement will produce an 8 byte string, TAX$. 

CVI, CVS, and CVD •";'< Data converts. String to numbers. 

To convert a string back to a number, the following functions are used: 

CVI(str$) str$ must be at least 2 bytes long 

CVS(str$) str$ must be at least 4 bytes long 

CVD(str$) str$ must be at least 8 bytes long 

EXAMPLE: • " ■ • •• 

v-'".' TH%=CVI(WF$): K!=CVS(FR$)-3 

■ ."■».'- • 

'-';-•. The string variables WF$ and FR$ were assigned to a buffer area via the 
"; t; FIELD statement. 
'".* '.''>', • V •■■'••-. ' " ■ ' ." 

.'"p LSET, RSET Place data in a RANDOM buffer area. 

■;! : r^pi- LSETstr$ =• exp$ RSETstr$ = exp$ ' . ' *'- ■ 

i"- 4 *- r a ".-;-•- .■•'.. - • ■ " ' • / ' • " '.'■'' 

5 - : 30-!' : " str $ = variab l e assigned to the buffer area via FIELD . •. \ ... 

■ v.\v-K^ "' ex P$ = th e assignment for str$ l : , * ' ' • 

4VeXAMPLE: _• . .. • ' . .,..' 

'v^U LSET WF$ ='mKI$(J%) 
."".'■^••.-l RSET DR $ = B$ + C$ 

.' • LSET and RSET will not increase the length of "str$". If "exp$" is longer 
• than "str$", then the characters to the RIGHT are truncated. 
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PUT - "• RANDOM wrLte statement. 

* - PUT[//]buf[,rec] 

buf *» a file buffer area 1 to 15. 
. : rec = the record number (1 to 32767, and -32768 to -1). If rec is 
omitted, the current record is used. The current record ia 
one unit greater than the last record written. 

The PUT statement will move data from the file buffer area to a specified 
record in a file. Each PUT statement will write to a file if the record 
length is 256 bytes. However, if record length other than 256 is used, 
(only possible using the V parameter at BASIC ini tillza tion) , then BASIC 
will wait until the I/O buffer area is full before a write is executed; 

•'•. 0PEN"R",1,"P0KER/TXT",67. .... '. 

If PUT statements were to write records 1, 2, 3, and 4 in this sequence, 
then it would take 4 PUT statements before a write is made to the file. 



1 

If- • 

'•-.V 1 '-.-*- '• r ••••■ The PUT statement requires the following actions to occur before a write: 
"i ':'if^ ; ^ ' ' '■■:'■' •-.-•--' • ._.-_, -x 

I ? V. -, : : C 1 ) 0P. EN a file, using modes "R", or "D", assigning a buffer area for I/O." 

1 "-7 """•;..•" (2) FIELD the buffer, assigning str$ to specific positions in the buffer. .; 

' I : > : \ , (3)LSET or RSET the data into the buffer area. The converting of numeric 
1 ■/.:-.;• - data to string data (MKI$, MKS$, or MKD$) can take place prior to the 
I ,, -. LSET or RSET statements or the conversion can take place during the 

'••,"...• • LSET and RSET statements. 

^N -'.' (4) PUT the data into the record via PUT buf [, rec]. 

J •_ . '.. If the record number in the PUT statement is greater than the number of 
,:;. : - * V. records In the file, then the PUT statement will increase the file by 
>'•"" '-;• ._ the necessary length to accommodate the record. 



•;.;.'• EXAMPLE: 

>■•:" .". 100 0PEN"R",1, "TEST/DAT", 40 
•iVA-rr- . -. " A • ;v •: ..•"/ 110 FIELD 1, 2 AS FD$, 8 AS MD$ , 30 AS XR$ 

:-•--••' ... 120 INPUT "What is your age";AG 

.•.."■:_.•. v 130 INPUT "What is yout narae";NM$ 

; 140 PRINT "OK ";NM$;", How many bytes can a Z-80 address"; 
150 INPUT ;BT! 

160 PRINT "I will keep a record of this data" 
. - . •• 170 F$=MKI$(AG) 

-180 LSET FD$ = F$ 
.'-?■-. ''*. ". " • • 190 LSET MD$ = MKD$(BT!) 
•j. ;•-.••.*-/;■'• " ' .*• 200 PUT 1,1 _ - 






** *i»? -" * . .'-." * - . -#■ * ..'■"'" •_* „**•«; v. 
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GET RANDOM record reader. 

GET[//]buf[,rec] 

buf = file buffer area 1 to 15. 

rec =* the "record number (1 to 32767, and -32768 to -1). If rec Is 
omitted, the current record is used. The current record is 
one unit greater than the last record read. 

The GET statement reads data from the fiLe to the file buffer area, reading 
sectors as necessary if the logical record length is less than 256. 

The GET statement requires the following to occur before a read. 

(1) OPEN the file (OPEN"R M ,buf , f ilespec or OPEN"D" ,buf , f ilespec) 

(2) FIELD the buffer area (FIELD buf, 1 AS X$, 233 AS Y$, ...) 

(3) GET the record 

(4) CVI, CVS, CVD as necessary. 

EXAMPLE: 

;/ -, 100 0PEN"D",1, "TEST/DAT" 

" : 110 FIELD .1, 4 AS JK$, 8 AS KL$, 30 AS LM$ 

120 GET 1, 1 

130 BYTES! = CVD(KL$) 

140 AGE% = CVI(JK$) 

150 C0MM$ = LM$ 

160 ... 

EOF End of file detector. 

EOF(buf) 

• ' i 

This function returns a zero if the end of file has not been read. 
Otherwise a -1 is returned. 

LOC File location indicator. 

'2i'..'r : .■ LOC (buf) 

This function returns the current record read for 0PEN"D" and 0PEN"R M . For 
0PEN"I", LOC returns the sector read (physical records). 

LOP Last record indicator. 

LOF(buf) 

This function returns the highest logical record for 0PEN"D" and 0PEN"R". 
For 0PEN"I M , LOF returns the highest physical record (sector). 



Page 104 



!&*'* 



.'»- 



• v.v 



1 






if 

1 * 



1 



:> 



I 
I 
I 
J 
J 
J 

1 

I 



"I"?-. •.':••»' 



3 



SUPERBASIC 
SUPERBASIC ERROR MESSAGES AND ERR CODES. 

ERR ERR/2+1 MESSAGE 

100 * 51 Field organization exceeded the logical record length. 

102 52 Internal error, use CMD"E" for specific, 

104 53 The buffer number is not available 

or wss used improperly. 

106 54 File' is not in specified directory. 

108 55 Incorrect file mode. 

110 56 File previously opened. 

112 57 Disk read error, use CMD"E" for specific. 

114 . 58 Disk write error, use CMD"E" for specific. 

116 59 File already exists. 

118 60 End of file encountered. 

120 61 Drive not available. 

122 62 Disk space full. 

124 63 "EOF" reached before any characters read. 

126 64 Bad "PUT" or "GET" parameter. 

128 . . 65 Improper file name. 

130 66 ' Access mode differs from OPEN mode. 

132 _ 67 I/O buffer overflow. 

134 68 Directory space full. 

136" . 69 Write protected media. 

138 ". 70 Incorrect password used to access file. 

140 v. - 71 Full directory. File cannot be extended. 

142 72 The file has not been opened. 

144 73 Undefined function. 

146 74 File not found. 

ERROR MESSAGE BREIF DEFINITIONS 

Access mode differs from open mode. - 

Bad "PUT" or "GET" parameter. - 

Directory space full. - All DIREC slots are used. See ZAP for DIREC detail. 

Disk read/write error, use CMD**E" for specific. - Use CMD"E", then refer to 
the DOS error message definitions. 

Disk space full. - All granules have been assigned. 

Drive not available. - Diskette not rotating in specified logical drive. 

End of file encountered. - An attempt is made to read 1 unit past the EOF. 

"EOF" reached before any characters read. - 

Field organization exceeded the logical record length. - The sum of the 

len for the len AS str" pairs in a FIELD statement is greater than the 
logical record length. 

File already exists. - 
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IMPORTANT RAM ADDRESSES 

COMMON - MODEL I and MODEL III (All numbers are HEXADECIMAL!) 

4015 thru 401C [KBDCB] - KEYBOARD DCB. 

401D thru 4024 [VODCBJ - VIDEO DCB. 

DCB+0 This byte normally contains 7. 

DCB+1,2 Driver address. 

DCB+3,4 Refresh RAM position. 

DCB+5 Character storage IE cursor is on. 

DCB+6 VIDEO cursor character. 

DCB+7 Space compression if 0. Special characters if 1. (MODEL III 

4025 thru 402C [PRDCB] - PRINTER DCB. 

DCB+0 This byte normally contains a 6. 

DCB+1,2 Driver address. 

DCB+3 Maximum number of printed lines per page. 

DCB+4 Line counter. 

DCB+5 Maximum number of characters per line. 

DCB+6 Character counter. V 

DCB+7^ The number of non-printed lines per page. 

402D thru 402F [TODOS] - Vector to Indicate the completion' of' 
command,, error or no error. v ^j.uu oc 



only) 



.>,-#•** ? 



a DOS 



the' wl U Jlll [ ulV " . eCt ° rS , t0 4 °? D af ter rese'tting Stack Pointer 'to 
pactp ; CiC ' A1 P» and Prompting the user "Insert SYSTEM <ENTER>". If in 
BASIC, vectors to function similar to 6CC on MOD I's. 

4053 [SPOOL] - This byte is described as follows: 

BIT • IF SET IF RESET 



inhibit LINK 

1 . '■ inhibit un-LINK 

2 •• inhibit ROUTE 

3 \ inhibit un-ROUTE 

4 '.;; ROUTE to file active . 

5 ' SPOOLER active 

6 * SPOOLER buffer full 

7 SPOOLER buffer has data 



permit LINK 
permit un-LINK 
permit ROUTE 
permit un-ROUTE 
ROUTE to file inactive 
SPOOLER inactive 
SPOOLER buffer not full 
SPOOLER buffer empty 



4054 [LINK] - This byte is described as follows: 



BIT IF SET 

PR linked to SO ' 

1 PR linked to DO 

2 .' DO linked to PR 

3 DO linked to SO 

4 SO linked to PR 

5 SO linked to DO 

6 PR output to SO 

7 Linefeed generated 

after each Carriage return 



IF RESET 

PR not linked to SO 

PR not linked to DO 

DO not linked to PR 

DO not linked to SO 

SO not linked to PR 

SO not linked to DO 

PR output to parallel port 

Carriage return alone 






N 



J 
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IMPORTANT RAM ADDRESSES J 

4055 [ROUTE] - This byte Is described as foLlows: 

BIT IF SET . IF RESET 

PR routed to SO PR not routed to SO 

1 PR routed to DO PR not routed to DO 

2 DO routed to PR DO not routed to PR . 

3 DO routed to SO DO not routed to SO , 

4 SO routed to PR SO not routed to PR . 

5 SO routed to DO SO not routed to DO 

6 , KI routed to SI KI not routed to SI ... 

7 SI routed to KI SI not routed to KI 

4056 thru 4057 [MEMTP] - Previous TOPMEM prior to executing the current 
"DO" file. ... 

4058 thru 4059 [D0BUF] - Pointer to current "DO" buffer. .:,..'. '-'■'" 

405A [NULLS] - Bits 7-4 contain the left margin, bits 3-4 contain the •'''•:'" 
number of NULLS sent after a linefeed. . . ..,.,• ... - „,-••—-' »' 

405B [DBLER] - This byte contains the primary disk I/O error code, if any. T 
This byte is reset to zero when the error is displayed or when the user is 
in the DOS command mode. 

405C [TAW] - This byte is set to a non-zero value when a drive is coming up 
to speed. 

405D thru 407F is used as DEBUG scratchpad when DEBUG is active. 

4080 thru 4151 is used as scratchpad and several DOS functions. CMD "uuuuu" 
saves BASIC'S use of 4080 thru 41E5. 

. 41E5 [STKLD] this Is the DOS stack address. 

4400 thru 4402 [DOS] - Vector to load Coramand/DOL and enter the DOS command j 

level. The Stack Pointer is loaded with the system stack, 41E5, and "DO" is . ■ 

checked. If "DO" is active, key characters are obtained from the "DO" file. 

..: If a "DO" is not active, the contents of KIM, 4047/4265 (MODEL I/III) is ; 

r. examined to see if the terminator was a comma, indicating a multiple dos ,J 

..;._ command. If the contents of KIM, is not a comma, "MULTIDOS" is printed and if 

.:>.;. the user can input a DOS command. . 



/ 4403 thru 4404 [DATA] - Storage area for extension data. 
.4405 thru 4407 [EXEC] - Vector to execute the command @ (HL). 
4408 [SAD0S] - Storage byte for repeat DOS commands. 
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4409 thru 440C [ERROR] - Entry point to DOS error library. Error message is 

the lower 5 bits of the A register. If bit 6 is set, then the decimal error 

is not printed. If bit 7 is set, then this routine returns to the caller. I 

If bit 7 is not set, this routine exits to 402D. J 



} 

# Li 
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IMPORTANT RAM ADDRESSES 

4419 thru 441B [CAT] - This Is a method of obtaining DIRectory data on a 

mounted disk. 

Entry: - 

A =* not used. 

B = function, (see below) 

C = logical drive spec. 

DE = not used. 

HL = RAM area, if function directs to RAM. 

Temporary exit: (if any of bits 3,4, or 5 is set in B at entry) Call again 
to get the balance of the directory. 

A <> with Z set if no error. 

HL = free granules. • , . 

BC = ? . • • ■ • 

DE = ? 

Full Exit: ' 

A =* error code if Z flag not set. "'. . r 

B = number of directory sectors read. ' • 

C = ?" ■..,-•-. ,..•■••..:>:. _ • - ..-•-• • -...-• 

HL - free granules. 

DE =■ last RAM byte used +1, else 0. 



Function: 

Bit pattern of B register 



BIT 

1 
2 
3 
4 
5 
6 



SET 

Place files in RAM. 
Include I files. 
Include S files. 
Bits 3 - 5 are the 
lower protect area 
in lines + 3. 
override bits 0-5, 
and return with 
free grans in HL. 
Return with error 
in A register. 



RESET 
Display to VIDEO. 



Display error at 
current cursor position. 



The A register contains the error, regardless of bit 7. 

When the directory information is directed to RAM, the format is: 8 bytes 
disk name, 8 bytes disk date, then 10 bytes for each file - padded to the 
right with spaces. • - . 

441C thru 441E [FILK] - DE => FCB (20 bytes), HL -> filespec. FILK 
transfers the filespec from (HL) to (DE). Case conversion will be in 
accordance to the bits in SMO. 

441F [VERB] - This byte contains the LSB of the WRITE routine. 



w 



■i:\j- 
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IMPORTANT RAM ADDRESSES 

File control block (FCB). 20 contiguous bytes of RAM designated by the 
user. Before open, the FCB has the fllespec left justified, terminated with 
an 0D or 03. After open the FCB is defined as follows : 

FCB+00: 

BIT 7 Set to indicate an open file. 

BIT Set forces CLOSE to write a new DIREC. This bit is set whenever a 
write is made to the file. 

FBC+01: 

BIT 7 Set if the file opened has a LRL <> 0, or byte I/O performed. 

BIT 6 Set by POSN (i.e. RANDOM I/O in BASIC). Having this bit set will 

retain the EOF on close, unless the file is extended. 
BIT 5 Set if the buffer does not contain the current sector. 
BIT 4 Set if the buffer contents have been changed. 
BITS 2-0 Access password level. 

FCB+02: Only used by BASIC during 0PEN"0" , or 0PEN"E". 

FCB+03 and FCB+04: Buffer address for reads or writes. Initially set to HL 

when INIT or OPEN is executed. 



FCB+05 



FCB+06 
FCB+07 
FCB+08 
FCB+09 



PNR. Position in Next Record (NRN - FCB+OA and FCB+OB) 



The drive number. 

DIREC position code. 

PER. Position in Ending Record. (ERN - FCB+OC and FCB+OD) 

LRL. Logical Record Length. 
FCB+OA and FCB+OB: NRN. Next record number, (actually one LESS than) 

FCB+OC and FCB+OD: ERN. Ending record number, (true) V. 

FCB+OE and FCB+OF: A copy of DiREC+16 and DIREC+17. 

The balance of the FCB - FCB+10 thru FCB+lF - contain data in 4 byte ^ -n LI 

" '"':• :'•'■ clusters. >.'-,■: 



FCB+10 thru FCB+13: First two bytes are the total granules prior, the next J • jl 

. byte is the starting cylinder for this extent, and the /•*/.' J 



last byte contains the relative granule (bits 7,6,5) 
and the number of contiguous granules less one (bits 
4,3,2,1,0). 



FCB+14 thru FCB+17, FCB+18 thru FCB+lB, and FCB+1C thru FCB+lF: Are the 
same as FCB+10 thru FCB+13. 
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IMPORTANT RAM ADDRESSES 



>v 



V: Several of the following entry points will return an error if something 
goes awry. This is indicated with "A = error". No error if "Z" flag set. 

TM?? th i r ? A nnrM [I ^oJ " DE = > FC t B ( Wi th f l leS P eC > > HL => 10 ° b y te buffer . 

INIT calls OPEN, 4424, to see if the file exists. If the file exists a 
return to the caller is made. Otherwise, the file is created with the 
logical record length set to the contents of the B register, then the file 
is opened and the "C" flag is set. A = error. 

4423 [NOW] - Drive selected scratchpad. '' ' ' 

4424 thru 4426 [OPEN] - DE => FCB (with filespec), HL = > 100 byte buffer. 
OPEN modifies the FCB containing the filespec to open. The LRL is extracted 
from the DIREC of the filespec and not from the B register. A = error. 

4427 [PORT] - A mirror image of the floppy diskette command. This byte is 
| interrogated by MEMDISK, and HARD DISK drivers. 

4428 thru 442A [CLOSE] - DE => FCB (opened). CLOSE completes the last write 
'. to the filespec, if necessary, updates the DIREC and dates the file. 

| . Mandatory after a write to a file. A = error. 

442B [DOING] - This byte contains the nesting level of "DO" activity. 

I . 442c thru 442E [KILL] - DE => FCB (opened). KILL deallocates all granules 

assigned to the filespec. A = error. 

. 442F [CDRN] - Drive number for logical drivespec during file OPENing. 

-•■' : ' ¥2° ? hrU 4A32 [L0AD] " DE =>FCB (filespec). LOAD places the filespec into 
-• ;..; RAM. A = error. 

' • ..: ." '■ '-J 7 "' 4433 thru 4435 [LRUN] - DE => FCB (filespec). LRUN calls LOAD, and pushes 
• : _:\tV : T.-V,.. the entry point. A return Is executed if the file has an attribute of EXEC 
V-V.-t- ; .':'-:V.:*.--.. 9r . ?^ = . e DEBUG ls act Lve, LRUN will execute DEBUG. A - error. 

' "■* ; "!'. : .*-: ,> .i 4436 thru 4438 [READ] - DE => FCB (opened). If the LRL *= 0, READ reads a 
■:.$K.-.'\ ■•■• : : - . physical record into the contents of FCB+3 and FCB+4. If the LRL O 0, READ 
-•«>-•- -''-.,'. transfers a LRL number of bytes from FCB+3 and FCB+4 to (HL), reading a 
I ■".' ' physical record into FCB+3 and FCB+4 as necessary. A = error. 

. :;; ; . .;;"■• 4439 "thru 443B [WRITE] - DE => FCB (opened). If the LRL - 0, WRITE writes'* 

':-,'->..• .> one physical record from the contents of FCB+3 and FCB+4. If the LRL O 0, 

J . '"'■ .. !S£ T ? transfers a LRL number of bytes from the (HL) to the contents of 

".,";• ., /CB+3 Jind FCB+4, writing. a physical record if necessary. A - error. .. .* ; ..(-. '; \- /■ 

■.::'.-. 443C thru 443E [VERF] - DE => FCB (opened). VERF calls WRITE then rereads "^3 

J , ; : • ...... the sector for parity, if a write to disk occurred. A = error. .i'^V^ 






443F thru 4441 [POBOF] - DE => FCB (opened). P0B0F sets the FCB to the • " •' ' 

status of a just opened file - position zero. A » error. : ' 

4442 thru 4444 [POSN] -DE => FCB (opened). POSN sets the FCB to the logical'" - 

record in the BC register. A = error. . ...V.- 
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IMPORTANT RAM ADDRESSES jt 

4445 thru 4447 [BCKSP] - DE => FCB (opened). BCKSP sets the FCB one logical 
record less than the FCB has. A = error. 

4 ^, thrU J!^n [ !° E ?! ] " DE => FCB <°P ened )« p OEOF sets the FCB at the end 
of file, POEOF should return the error 1C. 

444B thru 444C [DEXt] - Jump relative to DEXT. 

444D thru 444E [FUNCJ - FUNC contains the current overlay entry point. , , 

444F thru 4450 [FORCE] - FORCE points to the 4 byte test for floppy I/O 
error "record not found". If the first two bytes are changed to 18 and 02 
respectively, then automatic density recognition is defeated. 

4451 thru 4453 [DIVID] - DIVID divides the contents in the HL register by 
the contents in A register, leaving the quotient in the HL register and the 
remainder in the A register. If the A is zero on entry, HL returns FFFF. 

4454 thru 4455 [PARAm] - Jump relative to PARAM. ' :<■- /V-'w,. 

4456 thru 4458 [REVEC] - Jumps to a modified overlay loader entry point. - ,",* 

4459 thru 445B [ITS IN] - Exit point of modified overlay loader. ' A 

Ppnr R ^ rU f ppJSi " Dura P s 4 entlre VID[ ^ refresh RAM to the address In the ' 

PRDCB+1 and PRDCB+2, converting non-ASCII charactrers to periods. 

r 464 pMu rU r^ 6 u [ Sn2 F ! " IX =>FCB <°P enef O- CEOF returns with the HL - NRN, 

C =» PNR. If the FCB is positioned at the EOF, A =* 1C. If the FCB is '\ 

positioned beyond the EOF, A = ID. If the FCB is less than the EOF, A - 0. 

. .. 4467 thru 4469 [VOD] - HL =>message. VOD is the general message display < 

routine. VOD outputs a byte to PUTVO, 33, until it encounters a 03. or 0D '' 

terminator. Only the 0D terminator is sent to PUTVO. The HL register is 
••positioned one byte after the terminator character. 

'"•? A6 n„ill rU f 6C [PRT] " ^ =>messa 8 e - P R T is similar VOD, except the output ! 

; Is PUTPR, 3B, instead of PUTVO, 33. F 

.'."446D thru 446F [GTIME] - HL => 8 byte buffer. GTIME returns the current RAM B 

■ time in the format hh:mm:ss. On exit, HL is one position after the 8 byte Ll 

-: buffer, DE => [TIC], BC = 003A. y 

..".,4470 thru 4472 [GDATE] - HL => 8 byte buffer. GDATE returns the current RAM !| 

.. date In the format mm/dd/yy. On exit, HL is one position after the 8 bvte 'J 

r;. buffer, DE => hour, BC = 002F. a 

^■■extPnSnn f 7 ^{ DEXT J " ° E => FC ? (filespec). HL -> extension." DEXT puts " \ I 

...^extension in filespec if filespec does not have an extension. J 

• "It J*™ A ?J 8 f PAR AM] " DE -> parameter list. PARAM interrogates the i 

" ' i s of i?v T d f tS u the addresses accordingly. A parameter list I 

n2?!c a S J? char f cter Phrases, padded to the right with spaces if J 

necessary, followed by a two byte address, and terminated with a zero. 
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4479 thru 447B [DOTIT] 
software indicates the 
instruction when MULT I 
by using this sample p 



IMPORTANT RAM ADDRESSES 

- The FORMS routine will call this address when the 
form is at the top of page. DOTIT points to a return 
DOS is loaded. The user can place titles on printouts 
rograra. 



TODOS 
TOPMM 
DOTIT 
PRT • 



00001 

00002 

00003 

00004 

00005 

00006 START 

00007 

00008 . 

00009 

00010 : •". 

00011 MYCDE 
00012 
00013 
00014 

00015 ' ; ' 

00016 " w 

00017 MYTIT 
00018 

00019^ :..•": 



EQU 

EQU 

EQU 

EQU 

ORG 

LD 

LD , 

DEC 

LD 

JP ' 

EXX 

LD 

CALL 

OR 

EXX 

RET 

DEFM 

DEFB 

END 



402DH 

404911 

4479H 

446AH 

0FC00H 

HL, MYCDE 

(DOTIT+l),HL 

HL 

(TOPMM), HL 

TODOS 

HL, MYTIT 

PRT 

A 



'THIS IS MY WORK' 

0DH 

START 



JM0DEL I ADDRESS, USE 4411H FOR MODEL III 
JARBITRARY ADDRESS 



; PROTECTS ROUTINE 

JMULTIDOS DOESN'T USE ALT REGS. 

;CALL ITSELF (SAFE BECAUSE OF EXX) 
;MUST RETURN A NON ZERO 
;PUT 'EM BACK 
;BACK TO CALLER 



~> 



J 

■J 
J 
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447C thru 4483 [ADRQ] - If floppy, ADRQ loads DCT+0 with the contents of 
the A register, then sets DCT+6, DCT+7, DCT+8, and DCT+9, in accordance 
with DCT+O. ;.;• 

4497 thru 44A0 [LWAIT] - This routine will load the floppy disk controller 
with the contents of the A register, then wait approx. 30 micro seconds. 

44A1 thru 44AA [FPOSJ - IX => FCB. FPOS returns the ERN in the HL register, ". 
and the PER in the A register. - ■ .. ; . . 

44AB thru 44C8 [SEEK] - D = track, E = sector, C = logical drive. SEEK will 

position the floppy disk R/W head over the desired track. 

44C9 thru 44CB [MOTON] - Floppy disk drive select, and cotor turn on. \ V -)V;- 

44CC thru 44CE [GRDUM] - Dumps entire VIDEO refresh RAM to the address in''" 
the PRDCB+1 and PRDCB-l-2, including graphic characters. ■, , ■■ •;•- 

44CF thru 44D1 [ZZZZ] - A call to ZZZZ prints "Insert SYSTEM <ENTER>" f and- 
waits for the <ENTER> key pressed, then returns. \ y.':^i* 

44D8 thru 44D9 [LNKTO] - Contains address for LINK control. . '\ ''*" '■ 

44DA ."[GTDCC] - Position IY register to the DCT in the C register. 

44DB thru 44DD [GTDCT] - Position IY register to the DCT in the A register. 

44DE thru <i4E0 [READVJ - D = track, E = sector, C = logical drive. READV 
checks the sector for readability. A = error. 
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IMPORTANT RAM ADDRESSES 

... 44E1 thru 44E3 [READS] - D - track, E - sector, C - logical drive, HL - 100 
byte buffer. READS transfers the sector data into (HL) . A = error. 

■ 44E4 thru 44E7 [WRITS] - D - track, E = sector, C - logical drive, HL - 100 
byte buffer. WRITS transfers the data in (HL) to the sector. A = error. 

44E8 thru 44EA [DIRRD] - DIRRD issues a READS specifically looking for a 

. DELETED DATA MARK (DEM). DIRRD returns if a DDM sector is read otherwise 

DIRRD will read physical track zero, physical sector zero, relative byte 

two, and update DCT+3 with this byte (directory cylinder), then reads the 

Sm mppn* a ? w ^m^* V J he J 2 eW „ t F, ack » same sector does not cetu ™ a 
fl ,n Vi11 SI ? density 1, if »' P " density doesn't return a DDM, 
DIRRD will try »P» density2. If still a DDM isn't found, DDIRD will return 
-'■_• an error of 11. A = error. 

.<[ 44EB thru 44ED [DIRWT] - Same as WRITS, except issues DDM. A = error. 

•.;■; 44EE thru 44F0 [RDIRP] - On entry, the B register contains the DIREC 

•■;■••" R?d2£ 4 c ? de ' * nd the C register contains the logical drive number. The 

? .-..DIREC position code is a bit pattern loaded into FCB+7 when a file is 

57, opened. (The DIREC code is the ONLY way the system knows where to put any 

...,., new information." i.e. CLOSE. This is why you should NEVER change diskettes 

-• !™ H / file is opened, and will remain open until close is called even if 

- '"-NOTHING was written to the file. CLOSE simply checks the information in the 

'" ? u , ln the DIREC » lf CLOSE finds a difference, CLOSE will 

write the data in the FCB to the DIREC whose position code is in FCB+7.) 

. •;. Bits 7, 6, and 5 contain the relative offset in the sector. Bits 4, 3 2 

V./- 1 ' an t contain the relative directory FILE sector. If a directory starts 

1 ■•";*• : '" D °LS ^li SeCt °f °» then sector 2 is relative directory file, sector 0. 

■ ; i: : - :i: - code DI^FC r ?n U ^/T/n Wf^ r f gister P oi ^ing to the register B position 
\\> , .. code D1RE C, in the I/O buffer. A = error. 

,^; ; 44F1 thru 44F3 [WDIRP] - On entry, the B register contains the DIREC 
...V A V Position code, the C register contains the logical drive number, and the 

:llM?.:.i * * iS ln BUFF * WMRP Wil1 exit with HL => BUFF * A = error. 
V'-;^;44F4 thru 44F6 [USRF] - D = track, E = sector, C - logical drive,' 
V V^-?T " bu " er » and the A register contains the FCB code. USRF accepts any of 
•"r/^"- ^ - rea sector » write sector, or write track commands. A = error. 

..•*^«.^J\v»' > - •„'■• - 

:^#L-; : A4F J thru 44F 9 [GETDT] - On entry, C - logical drive. On 
•A'^tV-- 68 ter wil1 contain the contents of DCT+3 for the C register 

"$$*M* A thru 44FC [M0DE] - Called h Y CL °SE to see If any data ! has not been ! 

*&QU written to the file. n || 

•V' ; >V.i AFD T 5 hru 44FF [OPESA] - Checks for DE => FCB opened. If open saves BC , DE 
>.^; - . HL > IX » and IY registers, IX returned => FCB. ' ' 



exit the D j 

DCT. 






;.('• Pa 8 e HA 

■<■.- . 






1 

i 

j 



.-.' 



*'•. *• 



-—^. * Y 



*' V »>V- S \- 



} .', 



" v ~! 



") 



J 
J 



IMPORTANT RAM ADDRESSES 
4500 thru 457F [DCTS] ~ Eight. Drive Control Tables. 

DCT+00-. The main control byte containing the configuration information. 
Floppy bit pattern: 



BIT 
BIT 
BIT 
BIT 
BIT 
BIT 
BIT 
BIT 



Step rate LSB. 

Step rate MSB. 

If set - Double step cylinders with a single step command. 

If set - Perform a 1.8 to 1 division + 1 to read NEWDOS/80. 

If set - Perform a 1.8 to 1 division to read NEWDOS/80 MOD III 

If set - Double sided diskettes are treated as two volume. 

If set - 8" floppy, otherwise 5 1/4" floppy. 

Double density media, otherwise single density. 



If set 



HARD disk bit pattern: 
BIT . Step rate LSB. 
BIT 1 Step rate. 
BIT 2 ' Step rate. 
BIT 3 .Step rate MSB. 
BIT 4 ' : - SET TO ONE. 
BIT - 5 ' ' SET TO ZERO. 
BIT 6 SET TO ONE. 
BIT •*-:7.;v,:. SET TO ZERO. 



MEMDISK bit pattern: 

N/A 

N/A 

N/A 

N/A 
SET TO ONE 
SET TO ZERO 
SET TO ONE 
SET TO ONE. 



DCT+Ol: (NIL is indicated by having ALL bits set.) 



BIT 
BIT 
BIT 
BIT 
BIT 
BIT 
BIT 
BIT 




1 
2 
3 
4 
5 
6 
7 



Physical drive LSB. 

Physical drive. 

Physical drive MSB. 

MEMDISK. 

Set to one indicates HARD/MEMDISK. A zero indicates floppy. 

Used for HARD drives to indicate format pattern is logged. 

Set to one to indicate software write protect. 

Set to zero to indicate drive in system. 



the 



x 



mI1°k^ NU ? b ? r ? f J !? eads P er volume. I to 127. Floppies will also have 
high bit set to indicate a two head one volume format. , 

^^ ! 7 J n he directory cylinder. This byte is obtained from cylinder zero,- 
sector zero, relative byte two. *«w, 

w^Aqr The CU T nt / ylln ^ er Where the head was Positioned when thla drive 
ZL t« ?f C ^ e V? d a ?° ther drive ls selected - This byte is NOT where the 
£wo l ll l l '5*? d y ive ls selected - The Disk Controller contains the value 
where, the head is located when this drive is being accessed. 

DCT+05:- -Dynamic head number selected. J "'."'■ 

DCT+06: The number of sectors per granule. ' i 

DCT+07: The number of granules per cylinder. r - 

DCT+08: The number of sectors per track. 

DCT+09: The number of directory file sectors on the first surface. 



-'tf/1 



* *■ Hi 

■.'••■ ; ■"'. \ 

-r i -,*. •; !■ •. 
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IMPORTANT RAM ADDRESSES 
DCT+OA: The most significant byte for the number of sectors per cylinder. 
DCT+OB: The least significant byte for the number of sectors per cylinder. 
DCT+OC: The most significant byte for Lhe cylinder offset. 
DCT+OD: The least significant byte for the cylinder offset. 
DCT+OE: The head offset. 
DCT+OF: Not assigned.' ; .,—;... 
DCT+OA thru DCT+OF are not used by floppies. 

4580 thru 4CFF contain the code for the balance of DOS functions. 

M?°?/ h ynn T 51F i F 1S th u, MSIG ° verla y ar ea. Command/DOL, Debug/DOL, and 
Minidos/DOL also use this area. 6 » 






*: M' 



4E00 thru 51 FF is the DOS overlay area. . : '..*'«>#.? ■ 

■•••■• . . .*■••■'. -' '-~-. r i 

BACKUP/CMD, FORMAT/CMD, RS/CMD, VFU/CMD, ZAP/CMD, and the librarv m mman A ''■ ' • V^ " 

DIR use 4D00 thru 51FF. If AllocaU/DOL is called while uslL S?7?SS * • -' " 

ZAP/CMD, or the library command DIR, then'a memory conflict will occ^r* " - 

: This can only happen if a device is accessed while the device is routed to ' 
a file requiring more disk space or positioning beyond the fourth segment! 

"" UNIQUE MODEL I •:-.."! 

■ ' interrupt! " ^ ^ 1S lncrement ^ by one for each real time clock .// 

■ .'*. 4041 - seconds. ;• .... 

^ r*-: 4042 - minutes. ■ • ' \ . .' , . • ^ 

•-. . 4043 - hour. " ' . ' ". " ' \ - ' ' ; ! 

a?; 4044 - year. • . . ' 'J 

:-'> f 4045 - day. . ...... 

«;■.;".'• 4046 - month. ' .,' ;-■ v: '•'... ■"':' ■ ' ; . . ' 

function! 4 ° 48 tKIM1 , " P ° intS t0 the terralnaCor ^ after executing a DOS 

V<; : 40A9 thru 404A [TOPMM] - Contain the address of ' the "highest available"'' ' 

• t -••■ memory location ava-flahlA f^r- nnc nAcm *. ,v '»-«-s ,lt: *> t available 

V"- different va I,,p V^T™ run •• ^ temporarily sets this word to a 

'"'Ifit'-I' - value during CMD uuuuu" execution. 

VX;., 4200 thru 42FF [BUFF] - System I/O buffer. : . 

■ ■""'■modes [M ^t 'this ^TTS tQ ^iu^ Minldos - T he DOS and BASIC command 
" r 'n -er al I 7 a< ^^ ^ overlay loader sets this byte to a 

£;£ np ^^ and — this *** - -- **^ • 
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IMPORTANT RAM ADDRESSES J " 

430F [OLCJ - Overlay mask storage for the overlay in the overlay area when 
Mlnldos is invoked. Minidos will reload this overlay upon exit. • - ' 

4310 [OLB] - Overlay mask of: the overlay in the overlay area when a new 
overlay is executed. . ,,, 

4311 [OLA] - Current overlay mask. The overlay mask is bits 5,3,2,1, and 0. 

430C [SMO] - The following c-mments apply if the noted bit is set. ". " : ' :: ; 

BIT 0. During file OPENing this bit will be set if the file has an 
. attribute of EXEC or NONE. This bit is valid AFTER a file has been 
OPENed. '•:;.-• :■< 

BIT 1. Set if LRUN, 4433, is entered. - r: --- / •;.--•;,.. ^ 

BIT 2. Ignore PASSWORDS. Reset when file is OPENed. \- ."': ."- 

BIT 3. Don't RAM date. "Reset after file CLOSEd. : ■ l: ~ * • "• ' -^'•^ 
BIT 4. Set if EXEC, 4405, is entered. ...... ."- .T- 

BIT 5. Accept " V7/$%&<>?@ in a filespecT iJ '" J e - ,MJC; ' : " >■"• < -<' ^'- ; /-;;> «;^ 
BIT 6. Accept numbers as the first character in a filespec or extension. ' %: . 1 4>£ 
BIT 7. Do not convert lowercase to uppercase, (accepts > 3D in filespec. ). ^,^ ; 

430D [SMI] - The following comments apply if the noted bit is set. ' V.A "''£''.'• 

BIT 0. Debug active. . , t , ,.-.,. ,,., , . . ,.'?'• VtV 

BIT 1.. Libraryl/EXT is In RAM area 5200 to 68FF. V ' ^ ' '- < ' r ~ : lj v 

BIT 2. Llbrary2/EXT is in RAM area 5200 to 68FF. . \ ■.:-.• 
BIT 3. Library2/EXT RESTOR command executed. " ' ' 

BIT 4. Libraryl/EXT D1R command executed. , .... . . ,". .'... 

BIT 5. In BASIC. This bit is reset during CMD"uuuuu". ' " * 

BIT 6. Type ahead active. _ '■•:-'; 

BIT 7. "DO" active. 1 '' ;;,r,: ' "- ' • . :; •"''••'• •- ; -Aw 

••»..■- . . . • -' ' -....- .;:"••*> A 

4315 thru 4317 [EXDB] - Debug vector. If 4315 contains zero, DEBUG will not .">£ 

load when <SHIFTXBREAK> is pressed, regardless of bit in SMI. The DOS /" 

command interpreter interrogates bit in SMI and sets 4315 accordingly. vV 

(If bit Is non-zero, 4315 is loaded with C3.) '.V >...v;K\ 



■{^^'^■■- •'.* •->... 4318 thru 4357 [C0MBF] - DOS command mode input buffer. ' \ .• •.' v'^Vf' .V^' 



, 'T_t>»^ if'--' 






4359 [SUBY] - Loads HL with (HL)+1. ' ' : :<•>?:%??$£. 

435A "thru 435E [SUBZ] - Loads HL with (HL). ' " "" / 



<>:-**. 



: 4?-SSft\* : "- '-'"-A 440D thru 440F t DEBUG ] - Debugger load/execute entry. ""' / V -"V • ^|/S< 



•■7v?-tv- 



J 

■ < 

. ''..-•;--. register will be at the start of the routine upon entry. The current ''• 
| ';,,.: ' version of MULTID0S uses SLOT for the clock, and SLOT 3 for the spooler. '"" 

: ::.-.. ~- . 4A1 3 thru 4415 [DUS] '-Delete task in slot A. Uses AF,' DE, and HL. '" / •'- A 



■•> <ft 



^S^:^' •"**'- 441 ? thru 4412 t IUS J "" Insert a task in 1 of 4 slots. (25ms each). The aA^A 

"'"'"' register contains the slot number and the DE register contains the address v'V 

of the routine. When a interrupt task is entered, all registers have been .--*•''". 

saved and the interrupts are disabled and MUST remain disabled. The HL '"**■ 



,i'-*.- 
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;. ;•■ IMPORTANT RAM ADDRESSES , ^ 

- . UNIQUE MODEL III 

,•'■»' ' 

. . 4215 [MMB] - Same .as MMB, 430E, MODEL I. 
. <-- ■ " • 

, 4216 [TIC] - This byte circulates from IE to 01 for each real time clock 
interrupt. • 

4217 - seconds. 

4218 - minutes. 

4219 - hour. 

421 A - year. '/ " ", 

421B - day. • r ,.- : ' . ..' ;,; 1 . 

. .421C - month. ... '.''., 

■ ...4225 thru 4264 [COMBF] - DOS command mode input buffer. 

;. j,". 4265 thru 4266 [KIM] - Points to the terminator byte after executing a DOS 

V. function. ."*'•.. 

••*'?'■ 4267 thru 4269 [EXDB] -Same as EXDB, 4315, MODEL I. < •"-:.:. 

"."*426A [OLC] - Same as OLC, 430F, MODEL I. . ' .' 

",/..' 426B [OLB] - Same as'OLB, 4310, MODEL I. 

"." 426C [OLA] - SAME AS OLA, 4311, MODEL I. 

-"426D [SMO] - SAME AS SMO, 430C, MODEL I. 

^426E [SMI] - The following comments apply if the noted bit is set. 

"• ■•'/ BIT 0. Debug active. 

A *BIT 1. Libraryl/EXT is in RAM area 5200 to 68FF. 

.-••'..'■' BIT 2. Library2/EXT Is in RAM area 5200 to 68FF. 

;.;•'. BIT 3. Library2/EXT REST0R or SETC0M command executed. 

■.-•£'.'. BIT 4. Libraryl/EXT DIR command executed. 

••..'BIT 5. In BASIC. This bit is reset during CMD"uuuuu". 

*~ r 'r^BIT 6. Type ahead active. 

£-:'>'£ BIT 7. "DO" active. . •' . .- '" 

:<%V#;/y: :--- . - • . - ' ■ • '■■■■•" 

.£££4300 thru 43FF [BUFF] - System I/O buffer. 



^FS-Mf 1 thru 4412 [ T0PMM ] " SAME AS TOPMEM, 4049 thru 404A, MODEL I. 
'^vt-^T-^'-- 1 - •-'.-.'.'■•". ...-'• • 

;4;'.^ 4491 thru 4496 [ Rupp l - The first byte is a F3 when TYPE -AHEAD is Inactive, 
!:C\. or a ° when TYPE " AHEAD is active to keep the interrupts on during disk I/O. 

^:^MD2 thru 44D4 [IUS] - Insert a task in 1 of 4 slots. (33 l/3ms each). The 
•^.~~.. A register contains the slot number and the DE register contains the 
..;.>.. address of the routine. When a interrupt task is entered, all registers 
;•/;._. have been saved and the interrupts are disabled and MUST remain disabled. 
,:;,,, The HL register will be at the start of the routine upon entry. The current 
./•^version of MULTID0S uses SLOT for TYPE -AHEAD, and SLOT 3 for the spooler. 

-./; 44D5 thru 44D7 [DUS] - Delete task in slot A. Uses AF, DE, and HL. 
:V.; Page 118 ' 
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IMPORTANT RAM ADDRESSES 
OPTIONAL ZAPS for MULTIDOS 

Teed!) 11 SPeGd modiflcatlons - (MULTIDOS can perform disk I/O in high 

MODEL I - 

Most software high speed modifications for the MODEL I require an 
output to a I/O port. Due to size constraints, none of the library 
C ??? a ™l5 u aV ? a faclUt y to accomplish this task. However, MULTIDOS 
will OUT the byte in relative position FO to the PORT in relative 
position Fl located on track sector 1. 

STD FO OCFE 0000 0504 

The above partial ZAP screen of track one, sector zero, indicates an 0C 
will be output to port FE during initialization. 

model iii .;;'.. ' -'■"•••: : ;f: , '.v • '-• • -,-.-, : ' •,• 

The MODEL III version of MULTIDOS will set bit 6 of 4210 and 

_ output a 1 to port 5F during initialization. The code to accomplish 

this. is on track zero sector one from relative byte 0B thru relative 

byte 18. • ■ e 

HEX 00 F3ED 563A 0243 FE56 C200 0021 1042 CBF6 
10 CB6E 7E3D EC.3E 01D3 5F 



This expressed in assembly language Is 



LD 


lfc.MUNlU5 

HL,4210H 


SET 


6,(HL) 


SET 


4,(HL) 


,\ LD 


A,(HL) 


OUT ' 


(0ECH),A 


\ LD 


A,l 


\0 OUT 


(5FH),A 



relative bytes 
0B,0C,0D 
0E,0F 
10,11 
12 

13,14 
15,16 
17,18 



">'■}■ 



1 J :"'?•":■"■' '. R y tes 0E and 0F se t a MODEL 4 to 4MHz. Zero these two bvtes if vn.i'rf*' 

^^:: * ■■■::■-.■ ?° fc wan ' , the M ?? EL «• ^ lle ™™^& m the model nu a o ^ It 

-:-://-;'•::.-';■. ,.4MHz. Bytes 15, 16, 17. and 18 set the hdt.mfq >^^ ,.7i. l ..^ a 5 



4MHz. Bytes 15, 16, 17, and 18 sit the HOLMES boa^d to high speed U 
you want to sent a byte to another port, modify these bytesas desiredf 

.'.^;*iV". : --:V- •" : ( 2 ) Disk I /° tries, (distributed value = 05) '" '<' ' '.'■::.;■'. 

J '-'W^. ■ "'■- ' S ID ?s l l rnnn Vih{ t te(i ?i th ^ he , nuraber °* disk 1/0 tries set to 5.* 

-i / .'ryC:,;..;:v ..- -• . i£ is * s . a G( ? 0D value. If a diskette starts to give you errors wviip 

J '-.*■'. - ^1^ ""£" ° V /0 "S ZdT * *« ** '" "I-"" K„' F4 

J ;-;^>; :... dSnotSseone? """"i ° n ° <M0DEL Z) ' ° r "«« "«ro (SoDEL I?l" 
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•; .. , IMPORTANT RAM ADDRESSES 

(3) Head load delay, (distributed value = 04) 



up 






.; ' Whenever MULTJDOS selects a different drive, even if the motors are 

; ». to speed, a delay of 15ms occurs before an attempt is made to 

.' read/write to the newly selected drive. The amount of delay is in 

....... 3.75ms (MODEL I), or 3.79ms (MODEL II[) for each unit in relative byte 

:..'-.. F5 on track zero sector one (MODEL I), or sector zero (MODEL III). 

.>, -;..., DO NOT USE ZERO! ... 

(4) OPEN error codes, (distributed values = 18, 18) 

The error code most application programs expect when an attempt is made 

,, to access a file, and the "file is not found", is 18. This error can 

occur in three distinct circumstances. 1) The drivespec given does not 

... contain the file, 2) the drivespec given is not available, or 3) the 

file was searched for and not found on all mounted drives. Error code 

18 is correct for case 1, error code 08 is correct for case 2, and 

/ r error code IF is correct for case 3. So what! Nevertheless, for the ..... 

purist, the correct error code can be returned. This is accomplished by ^-V.^^- 
••>:.*•;>••• zapping the last 2 bytes in Open/DOL. Now wait a minute. OK, the last 2 . >w4^}'4- 
.,.-•; bytes to be loaded. The last four bytes in Open/DOL are 02, 02, 17, 4E. ■'.•, i /:J i 

. These four bytes are used by the system loader and are not part of the 'V'-.fr&'i-. 
-...-. executed code.. Therefore, the bytes to zap immediately precede these ' V-V.'^. ' 
•:'■•, ■. four bytes. Since' the MODEL I and MODEL III versions of Open/DOL are ^ ; 

.;■•;,. different, you will have to find them yourself! Being somewhat a r' I 

■ ;- purist, the MULTIDOS files were created with an Assembler that zeroes ':•-._• 

' .;; all unused bytes in the last sector. Ah ha! They won't be that 
i '-::-.. -, difficult to find after all. The first of the last two (six) bytes Is 

A ., •. . the error code returned if a drive is not available. The second of the ( 

.V.v/ ':'"... last two ( slx ) bytes is the error returned if the file was searched for 
':^ : {'-Vr. and — 0t found * Purist zap them with 08, and IF respectively. 

.'Vv^'" (5). Default value for SM0. (distributed value = 0) I 

;-?^fe->- ; --- — '-• •-■■• • .•••.■.'■'. 

'■Sife^' If any of the high three bits ln SM0 are set , the user can have unusual " I 

^;£^ : : : filenames. However, keep in mind not all operating systems recognize '• ,1 

^; : sP+;k .the new syntax. Relative byte F7 on track zero sector one (MODEL I) or I 

'^;^fc sector zero (MODEL III) is loaded into SM0 during initialization. ' ' 

htlUr ( 6 ) Default response for ZAP/CMD menu, (distributed value = 43) •'' :"'•." ,J 

•■n>irt^:!" : — .v- ■■•■•.■•.. '/.:■■■ ... -, .. , ; • • ■ V ... U 

'•&ffi&*'\ ZAP/CMD's first sector in relative byte 80, contain the menu default 
^V^> character. (This is the only user alterable default.) ZAP it, if you 

•^£->« •£"££" w a n t! •• ' . • ' ■ - • . - 

.$!&£.: ;yj :■■•'••..-•••■ .. . \>- -r- : '" ': ' \ 

"ifeS'X 7 ). Default' number of file buffer areas for BASIC (distributed value - 3) 

.v^'4s.fr : -v. BASIC/CMD ' s first sector in relative byte 84, contain the default •'"• iJ 

j'aUv,'.^ number of file buffer areas allocated during BASIC initialization. " 

>£>'-Xv please use a number in the range of 00 and OF. A number greater than OF 
vy-':." •"■-;. wil1 clobber part of BASIC/CMD code. I 

:V£&<:- ...'-.•. - ... ■ LI 

.'".M-Xr't. v « .. •■''.••, 

S%Ui' : '•:■■'. • . • . : • • •'"■■' 

£#$%&.;:>'. ' ." ' , ; " ■'"•'■- J 

V.V.-.'.- , , 

"$$?$*■ .■'..>■;..•■ / • . - ' 
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MODEL 4 MULTIDOS 
I. GENERAL (All numbers are hexadecimal) <' 

<CAPS> Is used to toggle between CAPS and upper/lower case. <SHIFT>0 does 
NOT toggle between CAPS and upper/lower case. 

<LEFTXSHIFT><F1> cancels <LEFT><SHIFT><F2>, and <LEFTXSHIFTXF3> 

< LEFTXSHIFTXF2> actlvates the <CLEAR> key as an ALT key. When the 
<CLEAR> key Is held down and an alpha key, A thru Z, Is pressed, the value 
returned will be the alpha key code plus 40. When the <CLEAR> key Is held 
down and a shifted (either <SHIFT> key) alpha key i 3 pressed, the value 
returned will be the alpha key code plus 60, i.e. <ALTxC> - 83. 
<ALTXSHIFTXD> - A4. The <LEFTXSHIFTXF2> function disregards the 
condition of the CAPS mode. . 



<LEFTXSHIFTXF3> activates the <CLEAR> key as an ALT CTRL key. When the 
<CLEAR> key is held down and another key is pressed (including <ENTER>, " 
<BREAK>, and the arrow keys) the value returned will be the key pressed 
plus 80. The <LEFTXSHIFTXF3> function recognizes the condition of the 
CAPS mode, i.e. <ALTCTRLXC> - C3, <ALTCTRLXSHIFTXC> - C3 - in CAPS. • >i 
<ALTCTRLXC> - E3, <ALTCTRLXSHIFTxC> - C3 - in upper/lower case. V -' 



<SHIFTXRIGHT-ARROW> only converts to the 32/40 character " mode 
keys are pressed when the input mode is at the first position. 



if these 



II. MEMORY MAP of Model 4 MULTIDOS (All numbers are hexadecimal) 

. , , ; f ;• __ . . • 

thru 7FF inclusive is used for device I/O handling, KEYBOARD driver, 
INTERRUPT handling, VIDEO driver, PRINTER driver, and TIMEKEEPING. 



, v% -:V-:.t. '".' '.* 



J ^.» : -ri-/";-. 



v.-,':.>/v- , 



Location 
(RST 0) 



-.: - -?,. 






Function 

[SUPV] CLS, VIDEO WIDTH, and FUNCTION KEYS 

FUNCTION ■ ' . . 

Clears display 

Set VIDEO to 64x16 and clears display 
Set VIDEO to 80x16 and clears display 
Set Fl thru F6 to null keys. 
Set Fl to routine @ DE. ".••'''';••. 
Set F2 to routine @ DE. ':.>; ■'■ ' 
Set F3 to routine @ DE. . •• • 
Set F4 to routine @ DE. <RTXSHIFTXF1> 
Set F5 to routine @ DE. <RTXSHIFTXF2> 
Set F6 to routine @ DE. <RTXSHIFTXF3> 
.. IGNORED. ^ ■ ■ : -..± 

IGNORED. • . - .' ; 

The KEYBOARD scan routine will execute the function, then 
return with the character in the A register. If a 
particular key Input is also desired, then LD A with the 
character just before the last RET instruction. Function 
key commands/characters do NOT repeat. 



INPUT 


USES 


A«=0 


AF 


A«l 


AF 


A=»2 


AF 


A =»3 , B "O 


AF 


A-=3,B=»1 


AF 


A-3,B-2 


AF 


A-3,B-3 


AF 


A-3,B»4 


AF 


A=»3,B-5 


AF 


A-3,B«6 


AF 


A»3,B>6 


AF 


A>3 


AF 



i- •' ',' "** 
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. ' - X 04 






' , ." : . 05 


thru 


07 



■'J;?:/ 



MODEL 4 MULTIDOS 

Contains 17 to indicate Version 1.7 

Contains the VIDEO width under software control. 

Vector to special first position keystroke when 40 is 
called. If the desired key is pressed, and a special 
function is desired, then remove (at least) the two calls 
from the STACK: 

POP HL " ;call to 0005 
POP HL ;restore register 
POP QQ jcall to 0040 , 

Not used in DOS. Same function in BASIC. 

Vectors to PARSE under DOS, otherwise same BASIC function. 
, [GETBT] Same as MOD I/III. ;. . - 
Same as MOD I/III. 
• . . [PUTBT] Same MOD I/III. 

Not used in DOS. Same function In BASIC. 
..;' Same as MOD I/III. 
.""Overlay load vector. <BREAK> key does NOT vector here I ' 
;-[GETKI] Same MOD I/III. 
.-.. Vector to load/execute DEBUG. Same as MOD I/III. 
:. [PUTVO] Same as MOD I/III. 
:: Interrup mode I. Same as MOD I/III. 

[PUTPR] Same as MOD I/III. 
•:-.. [LINE] Same as MOD I/III. 

[SUBY] 43 INC HL ;Thls uses wasted 
'• Y .; - , [SUBZ] 44 LD A, (HL) ; space in MOD I/III 

'•'.•>-.:"'■- .. •" - - .■-. ; . 45 
?":Y. . ■- ' 46 

•.:*. - "47 

.•: , ;V:-v • •''.'• 48 

:.,:.;"". 49 thru 4F [KWAIT] Same as MOD I /HI. 

."•■■..•>v 50 thru 54 [GETSI] - Functions similar to MODEL III. 

.':.;,; : : 5 5 thru 59 '• .".- [PUTSO] - Functions similar to MODEL III. . ■ . 

: P>; 5A - : [IMAGE] - Contains contents of PORT- 84. 

"V /: Ca. 5B '■'- 00 This byte must remain zero. " 

)V'f:g'. 5C thru 5D . : [WHERE] - Same as IB MOD I/III. 

v.y>^:5E & 5F . . /:/..:,. Extension of DELAY routine at 60. 

?--^"; : '-~' ' .' '"- : LD BC F780 to obtain a one second delay. 

i-X'^ 60 thru 65 • [DELAY] Same function as MOD I/III. 

;Y-iiJ; 66 thru 68 . NMI vector. 

••P;' : ^69 thru 7FF -Totally different code here (SUBJECT TO CHANGED 

; £i- 800 thra 2FFF Thls area ls loaded/used by BASIC and is expected to 
•/ -J;.;.-;, remain intact during a CMD'Viuuuu". If BASIC is not being used, then this 
.\.^area if free system RAM. 

.-.'.•;■■-, 3000 thru 37FF is used by DOS library command DIR, by CAT, BACKUP, FORMAT, 
. r iyW> ZAP* and BASIC. This area is handled as a psuedo-overlay area. This 
"■\> area can °e used, provided bit 4 of SMI (4222) is set. DOS and BASIC will 
:-,- : L5 heck the 3tatu8 of thl3 blt anc * reload this area, if necessary. 

,•'■;':■•./. <? 800 tnru 3BFF l3 psuedo RAM used for dectecting key presses. 
'■/";■•-;.' Page 2 • 



08 


thru 


OF 


10 


thru 


12 


13 


thru 


17 


18 


thru 


1A 


IB 


thru 


IF 


20 


thru 


22 


23 


thru 


27 


28 


thru 


2A 


2B 


thru 


2F 


30 


thru 


32 


33 


thru 


37 


38 


thru 


3A 


3B 


thru 


3F 


40 


thru 


42 


43 







INC 


HL 


LD 


A,(HL) 


INC 


HL 


LD 


H,(HL) 


LD 


L,A 


RET 





1 






. . . . .... "•.' ; "''V ''•"'•'-■. - '• ■ '.'.*.- r ■"- * '«*rt 
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MODEL A MULTIDOS , : 

3C00 thru 3FFF is used for VIDEO refresh RAM. ' '•'*'; 

VIDEO .codes. ' " : • ' 

0-6 Ignored. • •. , , 

7 Beep • 

8 Backspace cursor one position and erase character under cursor. 

9 Ignored. ■;■•'.. •- 

0A ■ Linefeed/carriage return and erase new line. 
OB-OG Ignored. •> , V\ 

OD Linefeed/carriage return and erase new line. . 

OE Enable cursor character. " ;r . 

OF Disable cursor character. '■'''':.%'" 

10 Enable reverse video and set reverse video high bit routine. ' ; ;..' 

11 Reset reverse video high bit routine. 

12 Set all VIDEO refresh RAM from cursor position to end of frame to '" 
the contents in A@ (404C). 

13 Position cursor to HOME position. , : .: 

14 .•"'■ Scroll VIDEO and cursor up one line. • : .'. ., 

15 v Swap space compression code with special characters. \-:-£ ? ' 

16 _ Swap alternate special characters with special characters. . : V 

17 Set video to WIDE display. ' ' :• 

18 Backspace cursor one position. • • '. • 

19 i Advance cursor one position. .. ..;.• 
1A -Advance cursor one line. „ • • ' 
IB .,'■_ Back cursor one line. 

"\ '"-'-' -; 1C ; HOME cursor, disable reverse video, and reset WIDE display.- 

J -. •:'•.-. ID :; Position cursor to beginning of line. • " .• 

) l- . . .--•' } E , Set a11 VIDEO refresh RAM from cursor position to end of line to 20. 

,u • Set all VIDEO refresh RAM from cursor position to end frame to 20. 



1 
1 
1 
1 

3D 

1 

1 



r -vt; 



l 



IF 

20-BF Display character at current cursor position and advance cursor. 

CO-FF Display N-0C0 spaces and advance cursor position accordingly. If in 

.. ;. special character mode, display character and advance cursor. 



'-^ ;J i ;: :'t ' ; LD - A, code 
>ff£Vi.\' '■&■"■ CALL PUTVO 



. r 



J"^-?" v; ""''-'}/. 0n exit A - Input and Z flag Is set. .-*•'- ' " : 'Z'^ : i'' 

• .;'■■> - 'y. : . : - •' . : '''-^r' ■••'■"' ' ^-'*'"'^-. •••:'- •■ r,: ' : '■' "',"•.' - ; - - ■ ' - "' ' '•-•' ' =■• . : ' • \-t^"'-.^ } 

J" : '?:"~*?''f.-'J; : ^ ,":V: V '«. •'- • ' - ..:>fy:-''^i-'--'-'±y:~s>}-:'''--' : -'-'' : • • •;".'- > - / .■/•• ;■.'...."- I'^rv-- 

';'fypy : '"/.I -':••);;,'. 4000 thru 4009 [KEYCL] - These bytes are used by the keyboard driver for : ' '■'•'&:' 
.,. ..X : ',A.v^V-^....n^Y rollover and scrath pad for KEY repeat rate. ..,.,.'. -V 

J"v-:V.V ; : ^: ^00A [BLDR] "- Line input <C LEAR > key override if non-zero. Places ;••'.. . 
.v.;,-i;,: ; . ■ -.-V ,. character into buffer. - - ...:' •• .• • V 

-i "" " 

J 
I 



Y: 
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MODEL 4 MULTIDOS 
400B [SPOOL] - This byte is described as follows: 



y 



BIT IF SET % • 

inhibit LINK ' 

i inhibit un-LINK 

2 inhibit ROUTE 

3 inhibit un-ROUTE 

4 ROUTE to file active 

5 • SPOOLER active 

. 6 SPOLLER buffer full 

7 SPOOLER buffer has data 



IF RESET 

permit LINK 
permit un-LINK 
permit ROUTE 
permit un-ROUTE 
ROUTE to file inactive 
SPOOLER inactive 
SPOOLER buffer not full 
SPOOLER buffer empty 



400C [LINK]'- This byte is described as follows: 



BIT \ IF SET ".;•; ' • 

"0 ' PR linked to SO 

1 .PR linked to DO 

2 DO linked to PR 

3 DO linked to SO • : 

4 - SO linked to PR 

5 SO linked to DO 

6 PR output to SO 

7 Linefeed generated 

after each Carriage return 



IF RESET 

PR not linked to SO 

PR not linked to DO 

DO not linked to PR 

DO not linked to SO 

SO not linked to PR 

SO not linked to DO 

PR output to parallel port 

Carriage return alone 



400D [ROUTE] - This byte Is described as follows: 






BIT • IF SET ■>':'■'. 

PR routed to SO or file 

. 1 PR routed to DO 

2 . DO routed to PR 

.3 - DO routed to SO 

,4 SO routed to PR or file 

,5 SO routed to DO 
.6 ■ ; \ , KI routed to SI 

; 7 ;:r SI routed to KI 



IF RESET 

PR not routed to SO 

PR not routed to DO 

DO not routed to PR 

DO not routed to SO 

SO not routed to PR 

50 not routed to DO 
KI not routed to SI 

51 not routed to KI 



^8 »M" file/ 00F fMEMTPJ - "• PreVi0US T0PMEM P rior to executing the current 

-V^i^: 10 thrU A011 [D0BU *"J ~ Pointer to current "DO" buffer. 

''"V/.-V A01 2 [NULLS] - Bits 7-3 contain the left margin, bits 2-0 contain thP 
,;;;.. number of NULLS sent after a linefeed. contain the 

■■■■>- : PriL [DBLERl ~J hi3 jc h y tQ contains the primary disk I/O error code (second 
,v; error message), If any. This byte is reset to zero when the error i, 
..-.displayed or when the user is in the DOS command mode. ' 

.. ;• 4014 [TAW] - This byte goes non-zero when a drive is commlng up to speed. 
...-;••. " Page 4 .."..' 
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MODEL 4 MULTIDOS 



4015 thru 40 1C [KBDCBJ - KEYBOARD DCB. " 7 

DCB+0 This byte normally contains 1. 

DCB+l^ Driver address. 

DCB+3,4 Driver address storage during route. '•• 

DCB+5 BIT RESERVED. 

1 RESERVED. 

2 Space compression. 

3 lowercase. 

4 key beep. " " * . 
•'".'": 5 blink. ■''';.'* "' - ,'•••■ 

6 graphics. <LEFTXSHIFT><F2> sets this bit. • • . . 

7 high bit set. <LEFT><SHIFT><F3> sets this bit. 

DCB+6 VIDEO cursor character. '" • •' V..* " :■• ■ \-.l~ .-..• "■ 

P 03 ^ \, V l T)E0 , scro11 protect. The number of lines protected is determined "•'" 
by the highest bit set. The number of lines - N+l where bit N is set; i.e." 1 
Set bit 4, protect 5 lines. (protect 1 to 8 lines.) ' V V'f • 

401D thru 4024 [VODCB] - VIDEO DCB. 

DCB+0 This byte normally contains 7. -<-'■ 

DCB+1,2 Driver address. , /. .•"&'.• 

DCB+3,4 Refresh RAM position. " * 

DCB+5 Character storage if cursor is on. 

DCB+6-:-; VIDEO column position. 

DCB+7/V.v VIDEO row position. 

4025 thru*402C [PRDCB] - PRINTER DCB. 

DCB+0 This byte normally contains a 6. 

DCB+1,2 Driver address. ' • ... 

DCB+3 Maximum number of printed lines per page. 

DCB+4 Line counter. j 

DCB+5 Maximum number of characters per line. 

DCB+6 Character counter. 

DCB+7 The number of non-printed lines per page; 

402D thru 402F [TODOSJ - Vector to indicate the completion of a 
command, error or no error. . ...... . 



.« -.;»t.- 



•it- 



DOS 



'^J;v : ' :" r ^-; 403 ° thru 4032 fDESS] - Vectors to 402D after resetting Stack Pointer to 

^::% ^:";;/ .;>' ^? X P° S sta ck, 42FE, and prompting the user "Insert SYSTEM <ENTER>". If in 

v:.;V'v/ ; .->./.- BASIC, vectors to function similar to 6CC on MOD I's. 

v^^V"^*'/^? 4033 ... [GRAF ^ ~ Set9 the keyboard to <LEFTXSHIFTXF2> mode. ' ■ . 

Y^^}\ :'+-•:& 4034 thru 4035 [ULIN] - Sets the keyboard to <LEFTXSHIFTXF3> mode. 

''$£' ••" ' "'*■■•• '"" '' 4036thru 4039 [UFUNJ - Sets the keyboard to <LEFT><SHIFTXF1> mode. 

^W: : : ' : 403A thru 403C [SIDCB] - DCB for the RS-232-C. .": 

'[v*\' . "' ^03D thru 403F [SODCB] - DCB for the RS-232-C. . - . 

*■ T-; : -' '' ■ " 404 ° [ TIC J This bytes Increases by one for each real time Interrupt. 

■ :'J;' '. . 4041 thru 4042 [BAUD] - RS-232-C default storage. • '- * 

I .V'./V,r • '•"•'.'•' 

^ !•• ~' 4043 thru 404B [TACKL] - TYPE-AHEAD key mask storage. 



J 
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. " - MODEL 4 MULTIDOS 

404C [A@] - Stores character for write to end of VIDEO when a 12 Is sent to 
VIDEO routine. 

404D [B@] - BREAK KEY status. If zero, the KEYBOARD will return a zero 
when <BREAK> is pressed. DOS command modes sets this byte to a non zero 
value. 

404E thru 405C [PARSE] - Increments the HL register pair, interrogates the 
byte in HL, skips spaces and returns with the "C" flag set if numeric, "Z" 
flag set if ":" or 0. 

405D thru 407F [DBST] is used as DEBUG scratchpad when DEBUG is active. 

.4080 thru 4151 is used as BASIC scratchpad and several DOS functions. 

^411C thru 4151 is reusable scratchpad. CMD "uuuuu" saves 4080 thru 41 IB. 

4152 thru 4157 i3 used as a mirror copy of the time and date. This area is 
;...•; updated every second. Used to recover the time and date after re-boot. 

- 4158 thru 41FF is used by the system to load overlays, has the LRUN 
routine, and time keeping tables. 

v * * v - 

, ' 4200 thru 4202 [EXDB] - Debug vector. If 4200 is zero, DEBUG will not load 
when <LEFTXSHIFTXBREAK> is pressed, regardless of bit in SMI. The DOS 
command interpreter interrogates bit in SMI and sets 4200 accordingly. 
, (If bit is non-zero, 4200 is loaded with C3.) 

' - : 4203 thru 4205 [HOMO] - VIDEO control. 

-^•,.•4206 thru 4208 [XYRO] - VIDEO control. " . . • 

}-.:r\: m 4209 - RESERVED. ' . -f 

■'■*'££' 420A thru 420F [RUPPJ - This byte is a F3 when TYPE-AHEAD is inactive. 
• "V.This byte is when TYPE-AHEAD is active to keep the interrupts on during 
j-.'^r diskette I/O. . . , „ .; , , ... ..-*..• 

r;\£>£;: ' : • ■ " ■ " ■.••.■•-■ '' ' • ' ~ •" '" - : 

T-v;^ 4210 [MODUT] - This is maintained in the same function as the MODEL III. 

r:V?',** 211 thru 4213 f pAGX ^ " This vectors to the routine which corrects the HL 
•.;;.'*^ register ^ KL register contains the relative cursor position offset by 3C00 
J.; ; ; : ;'r.;,,"" 3C0O to 437F) and updates the page bit for port 84. 

'•■ --•>;!•• 4214 - Not used." • .■.-'.. 

V.'^V- 4215 thru 4216 [CLON] - Pointer to clock routine. 

■*. 4217 - seconds. 
•■.-•', 4218 - minutes. 
; 4219 - hour. ' . 

. '. 421A - year. 
421B - day. 
;.:"/• 421C - month. . - 

v^c"; Page 6 ' • - 
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1 "V ";'•'. 421D [MMB] '- Set to non-zero to inhibit Minidos. The DOS and BASIC command 

I,..;./,'.;.' modes set this byte to zero. The overlay loader sets this byte to a non 

.-,:-.• zero while, loading an overlay, and resets this byte to zero after 

':.;.. completion of the overlay function. 

) ' % 421E [OLC] - Storage of overlay mask of the overlay in the overlay area 

when Minidos is invoked. Minidos will reload this overlay upon exit. 

J -,..; ./-''. -. 421F [OLB] - The overlay mask of the overlay in the overlay area when a new 
J ""-','.'': "..• overlay is executed. 

. *•-.."-• 4220 [OLA] - Current overlay mask. 

I " The overlay mask is bits 5,3,2,1, and 0. 

4221 [SMO] - The following comments apply if the noted bit is set. 

j . BIT 0. During' file OPENing thi3 bit will be set if the file has an 

I attribute of EXEC or NONE. This bit is valid AFTER a file has . been 

-•■-' .-. " ' " OPENed. - ,•■-: 

i ':.... BIT i. Set if LRUN, 4433, is entered. 

BIT 2. Ignore PASSWORDS. Reset when file is OPENed. ' " 

1 BIT 3. Don't RAM date. Reset after f ile"CLOSEd. , 

BIT 4. Set if EXEC, 4405, Is entered. 

I BIT 5. Accept l f, 0$%&<>?@ in a filespec. 

| BIT 6. Accept numbers as the first character in a filespec or extention. . 

BIT 7. Do not convert lowercase to uppercase. (accepts > 3D In filespec.) 

) . ■ 4222 [SMI] - The following comments apply if the noted bit is set. 

\ ""• • ••'' •'''■-'■''.. 

BIT 0. Debug active. 

BIT 1. Library 1/EXT is in RAM area 5200 to 68FF. 

I ,. • . - BIT 2. Library2/EXT is in RAM area 5200 to 68FF. 

( - BIT 3. Help/EXT is In RAM area 5200 to 68FF. 

;..:'. BIT 4. 3000 thru 37FF has been used. 

V-." ■■'./-.■ BIT 5. In BASIC. . This bit is reset during CMD'Wiuu". 

] ' '; '■■■' •■-•'•'.■ BIT 6. Type ahead active. ...'•• 

j «='•;..*•'-'. BIT 7. "DO" active. ' , '. 

j -••" ":"'-" ■'".;. ' 4223 thru 4224 [KIM] - Points to the terminator byte after executing a DOS 
J .' •"'•■ function. >,.■;- ..."'. 

, ;. •'. ".-;.' 4225 thru 4274 - DOS command mode input buffer. "' ; 

J . , -'.'■""' 4275 thru 42FD is the system stack area. 

| ::;..* 42FE thru 42FF contain 4030. (Safety valve) ' ! 

J ; i* - ' •-.• 4300 thru 43FF is the disk I/O BUFFER. _ r 
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MODEL 4 MULTIDOS 

4400 thru 4402 [DOS] - Vector to load Command/DOL and enter the DOS command 
.level. The Stack Pointer is loaded with the system stack, 42FE, and "DO" 
is checked. If "DO" is active, key characters are obtained from the "DO" 
file. If a "DO" is not active, the contents of KIM, 4223 is examined to 
see if the terminator was a comma, indicating a multiple doa command. If 
the contents of KIM, 4223 is not a comma, "MULTIDOS" is printed and the 
user can Input a DOS command. 

4403 thru 4404 [DATA] - Storage area for extention data. 

4405 thru 4407 [EXEC] - Vector to execute the command @ (HL). 

4408 [SADOS] - Storage byte for repeat DOS commands. 

4409 thru 440C [ERROR] - Entry point to DOS error library. Error message 
is the lower 5 bits of the A register. If bit 6 is set, then the decimal 
error is .not printed. If bit 7 is set, then this routine will return to 
the caller. If bit 7 is not set, this routine will exit to 402D. 

440D thru 4410 [DEBUG] - Debugger load/execute code. 

44L1 thru 4412 [TOFMM] - Contain the adrress of the highest available 
memory location available for DOS. BASIC temporarily sets this word to a 
different value during CMD "uuuuu" execution. 

4413 thru 4415 [MXLIN] - VIDEO maximum line condition. Returns in 40X10 
A -40, D-10; in 50X18 A=50, D-18. 

4416 thru 4418 [FIXRR] - This routine will return the corresponding refresh 
RAM location In the HL register pair when entered with B - row, and C - 
column. 

4419 thru 441B [CAT] - Obtaining DIRectory data on a mounted disk. 

Entry: 

A - not used. 

B - function, (see below) 

C - ;ogical drive spec. . 

DE - not used. 

HL - RAM area, if function directs to RAM. 

Temporary exit: (if any of bits 3,4, or 5 is set in B at entry). Call 
again to get the balance of the directory. 

A <> with Z set if no error. 

HL - free granules. 

BC - ? 

DE - ? .".*,. ... 

SP - free to abort reentry. However, proper abort is put OFF in OLA, 4220. 

Full exit: 

A - error code if Z flag not set. ^ 

B - number of directory sectors read. 

C - ? 

HL - free granules. 

DE - last RAM byte used +1 , else 0. 

Page 8 , 
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./.■-. . ," MODEL 4 MULTIDOS 

Function: . , . ■ 

Bit pattern of B register. 

BIT / . SET RESET 

Place files in RAM. Display to VIDEO. 

1 Include I files. 

2 Include S files. 

3 . Bits 3-5 are the 

4 • lower protect area 

5 in lines ■+• 3. 

6 override bits 0-5, 

and return with . • i 

' ' "'. ';'" . free grans in HL. > 

'7 . Return with error Display error at ; , 

in A register. current cursor position. ' • • 

The A register contains the error, regardless of bit 7. 

When the directory information is directed to RAM, the format is: 8 bytea 
disk name, 8 bytes disk date, then 10 bytes for each file - padded to the 
right with spaces. . ..'.,.• 

441C thru 441E [FILK] - DE -> FCB (20 bytes), HL »> filespec. FILK 
transfers the filespec from (HL) to (DE). Case conversion will be in 
accordance to the bits in SMO. 

441F [VERB] - This byte contains the LSB of the WRITE routine. 
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. ' MODEL 4 MULTIDOS 

File control block (FCB). 20 contiguous bytea of RAM designated by the 
user.' Before open, the FCB has the filespec left justified, terminated 
with an 0D or 03. After open the FCB is defined as follows: 

FCB-fOO: 

BIT 7 Set to indicate an open file. 

BIT Set forces CLOSE to write a new DIREC. This bit is set whenever a 
write is made to the file. 

FBC+O'l: -'-.."" r ' '••" 

BIT 7 Set if the file opened has a LRL <> 0, or byte I/O performed. 

BIT 6 Set by POSN (i.e. RANDOM I/O in BASIC). Having this bit set will 

retain the EOF on close, unless the file is extended. 

BIT 5 Set if the buffer does not contain the current sector. 

BIT 4 Set if the buffer contents have been changed. 
BITS 2-0 Access password level. 

FCB+02; Only used by BASIC during OPEN M 0", or OPEN"E 



FCB+03 and FCB+04: Buffer address for reads or writes. Initially set to 

HL when INIT or OPEN is executed. 

FCB+05: PNR. Position in Next Record (NRN - FCB+OA and FCB+OB) 

FCB+06: The drive number. . 

FCB+07: DIREC position code. 

FCB+08: PER. Position in Ending Record. (ERN - FCB+OC and FCB+OD) 

FCB+09: LRL. Logical Record Length. 

.FCB+OA and FCB+OB: NRN. Next record number. (actually one LESS than) 

FCB+OC and FCB+OD: ERN. Ending record number. (true) ; 

FCB+OE and FCB+OF: A copy of DIREC+16 and DIREC+17. 



v. 



. \ - 

' ' ."'.'"V 1 "- *- \ 



V;,..The balance of the FCB - FCB+10 thru FCB+1F - contain data In 4 byte 
^v 1 :';,-. > clusters. • 

^tr.^B+lO thru FCB+13:' First two bytes are the total granules prior, the next 

.f*~ ; ^ „ , b y te is the starting cylinder for this extent, and the 

::?>*■'.•' • last byte contains the relative granule (bits 7,6,5) 

~ ;.-"/' _ . and the number of contiguous granules less one (bits 

/;':,-:,> . - - 4,3,2, 1,0). . 

f. . FCB+14 thru FCB+17, FCB+18 thru FCB+lB, and FCB+1C thru FCB+1F: Are the 
... r same as FCB+10 thru FCB+13. 

;' Several of the following entry points will return an error if something 
. goes awry. This is indicated with M A - error". No error if "Z" flag set. 

: ? i: ; 4420 thru 4422 [INIT] - DE -> FCB (with filespec), HL -> 100 byte buffer. 
:JV Page 10 
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• MODEL 4 MULTIDOS 

. •' INIT calls OPEN,' 4424, to see if the file exists. If the file exists a 
,.,. return to the caller is made. Otherwise, the file is created with the 
logical record length set to the contents of the B register, then the file 
is opened and the "C" flag is set. A - error. 

4423 [NOW] - Drive selected scratchpad. 

s 4424 thru 4426 [OPEN] - DE -> FCB (with f ilespec) , HL - > 100 byte buffer. 
OPEN modifies the FCB containing the filespec to open. The LRL is 
. extracted from the DIREG of . the filespec and not from the B register. A - 
• \ . error. ..... 

4427 [PORT] -A mirror image of the floppy diskette command. This byte is 
-, ; \- interrogated by MEMDISK, and HARD DISK drivers. . 

V >;. 4428 thru 442A [CLOSE] - DE -> FCB (opened). CLOSE completes the last 
,..•. write to the filespec, if necessary, updates the DIREC and dates the file. 
-; Mandatory after a write to a file. A * error. 

,,'.,• 442B [DOING] - This byte contains the nesting level of "DO" activity. 

-- '442C~thru 442E [KILL] - DE -> FCB (opened). KILL deallocates all granules 
,.. ... . ,.. :v: • assigned to the filespec. A - error. . ' . 

•■-,'»..*>■..•">-:.•' *-'r r -- • ■•_-"'•' , '■•''. 

;V\VV.."'./-r'";7.."A- 2P . tCDRNJ " Drlve number for logical drivespec- during file OPENing. J 

\'/- :: - ' ■'•■'-;■".' p?3° th ™ AA32 [L0AD] - DE " >FCB (filespec). LOAD places the filespec into 
> _..:,... RAM. A - error. ■ 

■ ;iv ; V; *"; , "J«3 thru 4435 [LRUN ) - DE -> FCB (filespec). LRUN calls LOAD, and pushes 
:; .- : •• " • Il e M nSS ry i PO ?r"^o I J e J tUrtl l3 executed lf the file has an attribute of EXEC 

v;-i-v. : "", T v ': e e active, LRUN will execute DEBUG. A - error. • 

.ibl:t''- ^r:V;. ^36 thru 4438 [READ] - DE -> FCB (opened). If the LRL - 0, READ reads a 

; ill; N: ; C •: J S2r^ T c ecord into the contents of FCB+3 and FCB+4. If the LRL <> 0, 

r^Js.; :• •-.'•...'• ■'-'■-•■• REA J transfers a LRL number of bytes from FCB+3 and FCB+4 to (HL), readina 

' '- T iV.?--&: •■■'".''•-. - : '- - a P h y sical record into FCB+3 and FCB+4 as necessary. A - error. , 

;-^" 4439 thru 443B [WRITE] - DE «> FCB (opened). If the LRL - 0, WRITE writes" 

. one physical record from the contents of FCB+3 and FCB+4. If the LRL <> 
■"'■' 2SI5 ^ a ^n?^ S a , LRL number of b y tes from the (HL) to the contents of 
:">";• ; .. B+3 . aQ FCB+4 » writing a physical record If necessary. A - error. 

"f-V 443G thru 443E tVERF] - DE -> FCB (opened). VERF calls WRITE then rereads - 
: /.. t he . sector for parity, if a write to disk occurred. A - error. - . 

,V 443F thru. 4441 [POBOF] "- DE »> FCB (opened). POBOF sets the FCB to the 
status of a just opened file - position zero. A - error. 

4442 thru 4444 [POSN] -DE -> FCB (opened). POSN sets the FCB to the 
logical record In the BC register. A - error. 

4445 thru 4447 [BCKSP] - DE -> FCB (opened). BCKSP sets the FCB one 
logical record less than the FCB has. A - error. 
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\: '■" MODEL 4 MULTIDOS 

• : 4448 thru 444A [POEOFJ - DE -> FCB (opened). POEOF seta the TCB at the end 
.^. of file. POEOF should return the error 1C. 

444B thru 444C [DEXt] - Jump relative to DEXT. 
' 444D thru 444E [FUNC] - FUNC contains the current overlay entry point. 

. . 444F thru 4450 [FORCE] - FORCE points to the 4 byte test for floppy I/O 

• error "record not found". If the first two bytes are changed to 18 and 02 
, respectively, then automatic density recognition is defeated. 

". 4451 thru 4453 [DIVTD] - DIVID divides the contents in the HL register by 
the contents in A register, leaving the quotient in the HL register and the 
;. remainder in* the A register. If the A is zero on entry, HL returns FFFF. 

• , 4454 thru 4455 [PARAm] - Jump relative to PARAM. 

l . 4456 thru 4458 [REVEC] - Jumps to a modified overlay loader entry point. 

. . 4459 thru 445B [ITSIN] .-Exit point of modified overlay loader. 

. 445C thru 445D [PUNCH] - Points to address of the 10 byte table which has 
the code^ returned for the "ENTER", "CLEAR", "BREAK", arrows, and 

445E thru 4460 [DSTAT] - Returns the status of the logical drive in the C 
register. The "Z" flag will be reset if no disk, the "Z" flag will be set 
if disk mounted, and the "C" flag will be set if write protected. 

4461 thru 4463 [JKL] - Dumps entire VIDEO refresh RAM to the address in the 
PRDCB+1 and PRDCB+2, converting non-ASCII charactrers to periods. 

. : -4464 thru 4466 [CEOF] - IX =>FCB (opened). CEOF returns with the 

HL - NRN, C - PNR. If the FCB is positioned at the EOF, A = 1C . If the 

•FCB is positioned beyond the EOF, A = ID. If the FCB is less than the EOF 

•'\.„A - 0. ■..-.. -K '■ ■■,■:■.:■; ' ■ <>.'.;'„■;■ i -,-■..' * 

.4467 thru 4469 [VOD] - HL =«>message. VOD is the general message display 
. routine. VOD outputs a byte to PUTVO, 33, until it encounters a 03, or 0D 
. , terminator. Only the 0D terminator is sent to PUTVO. The HL register is 

• positioned one byte after the terminator character. 

:'•; 446A thru 446C [PRT] - HL =>message. PRT is similar VOD, except the output 
;- : _; is PUTPR, 3B, instead of PUTVO, 33. . . . .. 

V 446D thru 446F [GTIME] - HL ~> 8 byte buffer. GTIME returns the current 
- RAM time in the format hh:mm:ss. On exit, HL is one position after the 8 
byte buffer, DE -> [TIC], BC - 003A. 

."■ .>- .- * . . 

' p A ? 5 hrU 4 ^ 72 i GDATE ^ ~ HL -> 8 byte buffer. GDATE returns the current 
- RAM date in the format mm/dd/yy. On exit, HL is one position after the 8 
_, byte buffer, DE -> hour, BC - 002F. 

' extL^nn J 4 "^™* -»*?> ™ (fUeapec) . HL -> extention. DEXT puts 
. . extention in filespec If filespec does not have an extention. 

v'-"« ' . ' 
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MODEL 4 MULTIDOS 

UlLt^ i 4 ? 7 ? IPA 5 AMJ " D ? -> P arame ter list. PARAM interrogates the 
rnnoT!^ p <*** u SetS the * ddre88es accordingly. A parameter list 
So^f-i- * if * character phrases, padded to the right with spaces if 
necessary, followed by a two byte address, and terminated with a zero. 



4479 thru 447B 
software indi 
return in9truc 
printouts by u 



TODOS 
TOPMM 
DOTIT 
PRT 



00001 
00002 
00003 
00,004 

00005 - ' 

00006 START 
00007 
00008 -:•■: 
00009 
00010 

00011 MYCDE 
00012 
00013 

00014-' . •■■•■■ 
00015- 
00016 

00017 MYTIT 

00018 ' .: , 
00019 



[DOTIT] 
cates th 
tion when 
sing this 

EQU 

EQU . 

EQU 

EQU ' 

ORG 

LD 

LD 

DEC 

LD - 

JP ■■■ . 

EXX ' 

LD 

CALL 

OR ' 

EXX 

RET 

DEFM 

DEFB 

END 



- The FORMS routine will call this address when the 

e form is at the top of page. DOTIT points to a 

MULTIDOS is loaded. The user can place titles on 

sample program. 



402DH 

4049H 

4479H 

446AH 

0FC00H 

HL, MYCDE 

(DOTIT+l),HL 

HL 

(T0FMM),HL 

TODOS 

HL, MYTIT 

PRT 

A 



'THIS IS MY WORK' 

0DH 

START 



JMODEL I ADDRESS, USE 4411H FOR MODEL III 
; ARBITRARY ADDRESS '- 



; PROTECTS ROUTINE 

jMULTIDOS DOESN'T USE ALT REGS. 

;CALL ITSELF (SAFE BECAUSE OF EXX) 
;MUST RETURN A NON ZERO . . ■ 
;PUT 'EM BACK 
;BACK TO CALLER 



J 
J 



J 
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447C thru 4483 [ADRQ] - If floppy, ADRQ loads DCT-H) with the contents of ' 
with DCT^O? ter :', Q SetB DGT ' Hi, DCT+7, DGT+8 ' and rcT+9 » in accordance 

"■• 4497 thru 44A0 [LWA IT] - This routine will load the floppy disk controller^ 
• with the contents of the A register, then wait approx. 30 micro seconds. .•; 

... 44A1 thru 44AA [FPOS] - IX »> FCB. FPOS returns the ERN In the HL " 
register, and the PER In the A register. : . . /, 

.. 44AB thru 44C8 [SEEK] - D - track, E - sector, C - logical drive. SEEK '• 
';■. ^ position the floppy disk R/W head over the desired track. 

; 44C9 thru 44CB [MOTON] - Floppy disk drive select, and motor turn on'. " : '• ' ' 

t^nwJ^Jn^L ~< ^ m 2 3 entlre VIDE0 refresh ^ ^ the address in . 
the PRDCB+1 and PRDCB+2, including graphic characters. 

44CF thru 44D1 [ZZZZ] - A call to ZZZZ prints "Insert SYSTEM <ENTER>'\ and 
waits for the <ENTER> key pressed, then returns. . . •/ 

Tt D2 >^ rU 4 4 D4 UUSJ " Insert a task ln l of 8 8lots - (numbered thru 7). 
^Mr«« ^F ^ er co " talns £* slot nuraber ^d the DE register contains the 
address of the routine. When a interrupt task is entered, the AF, BC , DE. 
and HL register pairs have been saved and the interrupts are disabled and 

., ' . Page 13 ->. ; 



•■..:'■; '■ '". MODEL 4 MULTIDOS 

.. MUST remain disabled. The "HL" register will be at the start of the 
... routine upon entry. The current version of MULTIDOS uses SLOT for the 
. clock, SLOT 1 for TYPE-AHEAD, SLOT 2 for utilities, and SLOT 3 for the 
spooler. 

.' 44D5 thru 44D7 [DUS] - Delete task in slot A. Uses AF, DE, and HL. 

. 44D8 thru 44D9 [LNKTO] - Contains address for LINK control. 

44DA [GTDCC] •- Position IY register to the DCT in the C register. 

•. 44DB thru 44DD [GTDCTJ - Position IY register to the DCT in the A register. 

44DE thru 44E0 [READV] - D = track, E - sector, C « logical drive. READV 
checks the sector for readibility. A - error. 

44E1 thru 44E3 [READS] - D = track, E" » sector, C - logical drive, HL - 100 
byte buffer. READS transfers the sector data into (HL). A - error. 

44E4 thru' 44E7 [WRITS] - D - track, E - sector, C - logical drive, HL - 100 
byte buffer. WRITS transfers the data in (HL) to the sector. A - error. 

44E8 thru 44EA [DIRRD] - DIRRD issues a READS specifically looking for a 

; DELETED DATA MARK (DDM) . DIRRD returns if a DDM sector is read, otherwise 

DIRRD will read physical track zero, physical sector zero, relative byte 

two, and update DCT+3 with this byte (directory cylinder), then reads the 

new TRACK, same sector. If the new track, same sector does not return a 

DDM, DIRRD will try "P" densityl, If "p" density doesn't return a DDM, 

■ DIRRD will try "P" density2. If still a DDM isn't found, DDIRD will return 

• an error of 11. A * error. 

. ' 44EB thru 44ED [DIRWT] - Same as WRITS, except issues DDM. A » error. 

■;V44EE thru 44F0 [RDIRP] -On entry, the B register contains the DIREC 
v\ position code, and the C register contains the logical drive number. The 
: .\$> DIREC position code is a bit pattern loaded Into FCB+7 when a file is 
.•:•;'/ "opened. (The DIREC code is the ONLY way the system knows where to put any 
:>^'new information; i.e. CLOSE. This Is why you should NEVER change diskettes 
k. after a file is opened, and will remain open until close is called even If 
•:•". NOTHING was written to the file. CLOSE simply checks the Information In the 
FCB with the data in the DIREC, if CLOSE finds a difference, CLOSE will 

*:.?,;•;,; write the data in the FCB to the DIREC whose position code is In FCB+7.) 

v : >-. Bit8 7 » 6 » and 5 contain the relative offset in the sector. Bits 4, 3, 2, 
r a 1, and contain the relative directory FILE sector. If a directory starts 

X'^ion physical sector 0, then sector 2 is relative directory file sector 0. 

.*>.;. RDIRP will return with the HL register pointing to the register B position 
■y^ code DIREC, in the I/O buffer. A - error. 

;^: 44F1 thru 44F3 [WDIRP] - On entry, the B register contains the DIREC 
'•position code, the C register contains the logical drive number, and the 
.-.V: .information is in BUFF. WDIRP will exit with HL =»> BUFF. A - error. 

':- 44F4 thru 44F6 [USRF] - D - track, E - sector, C - logical " drive, 
■■_•-,. HL - buffer, and the A register contains the FCB code. USRF accepts any of 
. ;.; ;i the read sector, write sector, or write track commands. A - error. 

Ss-i- ■' 
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- MODEL 4 MULTIDOS 

44F7 thm 44F9 [GETDT] - On entry, C - logical drive. On exit the D 
register will contain the contents of DCT+3 for the C register DCT. 

44FA thru 44FC [MODE] - Called by CLOSE to see if any data has not been 
written to the file. 

44FD thru 4AFF [OPESA] - Checks for DE -> FCB opened; If open saves BC , 
DE, HL, IX, and IY registers, IX returned =»> FCB. 

4500 thru 457F [DCTS] Eight drive control tables. 

DCT+00: The main control byte containing the configuration infomation. 

Floppy bit pattern: . . •■'..; .. 

BIT - Step rate LSB. : " ' - 

BIT 1 Step rate MSB. 

BIT 2 If set - Double step cylinders with a single step command. 

BIT 3 If set - Perform a 1.8 to 1 division + 1 to read NEWDOS/80. 

BIT 4 If set - Perform a 1.8 to 1 division to read NEWDOS/80 MOD III. 

BIT .5 ... If set - Double sided diskettes are treated as two volume. 

BIT 6 If set - 8" floppy, otherwise 5 1/4" floppy. 

BIT ~' : 7 If set - Double density media, otherwise single density. - 



Hard disk bit pattern: 

BIT \ • Step rate LSB. 

BIT 1 Step rate. 

BIT 2 Step rate. 

BIT 3 Step rate MSB. 

BIT 4 SET TO ONE. 

BIT 5 SET TO ZERO. 

BIT 6 . SET TO ONE. 

BIT 7 . SET TO ZERO. 



MEMDISK bit pattern: 
N/A 
N/A 
N/A 
N/A 
SET TO ONE 
SET TO ZERO 
SET TO ONE 
. SET TO ONE. 



DCT+01: (NIL is indicated by having ALL bits set.) 

BIT . .0 . Physical drive LSB. -' ' . . \ 

BIT 1 . v Physical drive. 

BIT 2 : Physical drive MSB. 

BIT 3 ... MEMDISK. " 

BIT 4 ■ Set to one indicates HARD/MEMORY. A zero indicates floppy.' 

BIT 5. ; . Indicate format pattern is logged, (no update to DCT+06-0F) 

BIT. 6 . , m . Set to one to Indicate software write protect. 

BIT 7 • Set to zero to indicate drive In system. 



.•*• ••/*«' 
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DCT+02: Number of heads per volume. 1 to 127. Floppies will also have the 
high bit, set to indicate a two head one volume format. 

DCT+03: The directory cylinder. This byte is obtained from cylinder zero, 
sector zero, relative byte two. 

DCT+04: The current cylinder where the head was positioned when this drive 
was LAST accesed and another drive is selected. This byte is NOT where the 
head is, If this drive is selected. The Disk Controller contains the value 
where the head is located when this drive is being accesed. 

Page 15 



DCT+05 
DCT+06 
DCT+07 
DCT+08 
DCT+09 
DCT+OA 
DCT+OB 
DCT+OC 
DCT+OD 
DCT-fOE 
DCT+OF 



MODEL 4 MULTIDOS 

Dynamic head number selected. 

The number of sectors per granule. 

The number of granules per cylinder. 

The number of sectors per track. 

The number of directory file sectors on the first surface. 

The most significant byte for the number of sectors per cylinder. 

The* least significant byte for the number of sectors per cylinder. 

The most significant byte for the cylinder offset. 

The least significant byte for the cylinder offset. 

The head offset. 

Not assigned. " 



DCT+OA thru DCT+OF are not used by floppies. 

For floppies, DCT+06 thru DCT+08 are updated each time the DOS must invoke 
automatic data recognition. The default values are: 







DCT+06 


DCT+07 


DCT+08 


DCT+09 


5 


' SD/SS 


5 


2 


10 


8 


5 


' SD/DS 


5 


4 


10 


8 


5 


' DD/SS 


6 


3 


18 


16 


5 


' DD/DS 


6 


6 


18 


16 


8 


' SD/SS 


8 


2 


16 


14 


8 


' SD/DS 


8 


4 


16 


14 


8 


' DD/SS 


10 


3 


30 


28 


8 


' DD/DS 


10 


6 


30 


28 



A user can establish other values to read a special format pattern by 
placing the respective values in the DCT and set bit 5 of DCT+01. 

EXAMPLE: NEWDOS/80 PDR1VE setting with TC=80, SPT=36, GPL=8, and DDGA-6. 

DCT+00 - lOOHOxxB '. - 

DCT+02 - 100000 10B 

DCT+06 » 5 ("....there are still 5 sectors per granule."). 
DCT+07 - 8 (GPL) 
: - DCT+08 - 18 (SPT/2, NEWDIOS/80 double sided diskette one volume) 
DCT+09 =■ 28 (DDGA * 5 - 2, 5 - DCT+06, 2 ■= 1 GAT + 1 HIT) 

4580 thru 4CFF contain the code for the balance of DOS functions. 

4E00 thru 51FF is the overlay area. 
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y ; ' * Model 4 & Max-80 BASIC 

IIX * BASIC (All numbers are decimal unless suffixed with an H) 
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When editing a line the <RIGHT-ARROW> moves the cursor one space as the 
< SPACE -BAR >. The <E>xit function has been deleted. 

The REFERENCE utility is invoked with the "@ M key. 

Under BASIC shorthand the user can backspace to use the single keystroke 
commands. ( [<SHIFT>]up-arrow, [<SHIFT>] down-arrow, comma, period, and 

slash) .... -,. . .-••• ,. . 

Single letter commands. ; . * 

A[n][,ml v...,,. # Auto line numbering starting at n (default 10) 

. ••— " .'•'.• incrementing by m (defaul 10) 

C •._'-;•- Continue program execution after STOP. 

D[n][-m] Delete lines from n to m. (Changed to have similar 

syntax to LIST, m does not have to be an existing line; 

, : however, at least one line should be between n and ra.) 

,E[n] ;,. . ,■ . Edit line n. (Default current line) 

•I '."■'"'• ; ' : . ;"" Insert. Invokes (psuedo) A .+1,1 . J 

K"program ' Remove program 

L[n][-m] ,, List lines from n to m 

L"program : , Load program 

Mn,m. 'V : Move line n to m 

Nn,m . Duplicated line n at ra 

p t n J ..->. List P a 8 e of lines from n (defaults current line) 

R [ql ; /^ .', Run program starting at line q (see note) 

R if " ' Run program starting at the first line 

R program Load and run program 

S"program Save program 

The period "." may be used for n or m to represent the current line. 

NOTE: q - .line number or a mandatory space LABEL"label" (RUN LA BEL "DOGGY") 

TRON has 7 additional functions when followed by the numbers 1"- 7. '•/"•' 

TRON or TRON - Trace in the upper right corner of display. '''">. 

TRON 1 - trace to line printer. .....,•. 

TRON 2 - display "the BASIC statement in the lower left corner BEFORE it is 
; - " ; executed. 

TRON 3 - single step with delay. Delay is controlled via <CTRL><D> to 
••:•»••■' :■ increase delay, and <CTRLXF> to decrease delay. (need <CTRXS> 

between each delay change - see below) ...•■•' 

TRON 4 - single step line. -'•"..■. ' ." .C ' 

TRON 5 » single step instruction. 

TRON 6 - single step off.- '. ' ;; •. -.. 

TRON 7 - display erroneous statement. 

Once TRON is envoked, <CTRL><Q> thru <CTRL><W> will modify a TRON from " 
TRON 1 to TRON 7 respectively; i.e. <CTRLXS> will modify a TRON 2 to be 
TRON 2 and TRON 3. A <CTRLXV> will remove a TRON 2. 

TRON or TRON and TRON 1 are mutually exclusive/. 
TRON 4 and TRON 5 are mutually exclusive. 
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Model 4 & Max-80 BASIC 

CWD functions 

B "Soft" disable of "BREAK" key. 
C Invoke "SPACE COMPRESSION" utility. 
D Invoke debug. 

E Interrogate last disk related error after BASIC initialized. 
P Invoke "PACKER" UTILITY. 
Q Dual/single dimension string sort. 
S Exit BASIC. 
•. U Invoke "UNPACKER" utility. 

V Display active scalar variables. , . •. 

X Invoke "REM REMOVER" utility. 

CMD "uuuuu" requires a minimum of 6080 free bytes to execute. 

If less than 6080 bytes are free, then the message 

ignored! . 

vill be displayed and a return to the next statement, (if any), will occur. 

KEYWORD changes 

CLEAR - Clears all variables, closes all OPENed files, resets execution 
pointer, nullifies all FOR-NEXT loops, and GOSUBS; resets ON ERROR/STOP 
GOTOs, resets all variables to their default type, and activates the 
<BREAK> key. 

CLEAR nnnnn - (nnnnn ■ to 32767, -32768 to -1) Changes the amount of 
space allowed for string storage, and nullifies all FOR-NEXT loops and 
GOSUBs. Although nnnnn can be less than - 32768, a number much less than 
-25000 will produce an "Out of Memory" error. 

ON STOP GOTO line number/"label" - This command will deactivate the <BREAK> 
key in a user input mode, and cause a branch to line number/"label" if the 
7 <BREAK> key is pressed during program execution. 

" GOTO "label" . 

y\ GOSUB "label" 

'RESTORE line nuraber/"label" 
•V " ON ERROR GOTO "label" 

-;-; ON n GOTO/GOSUB "label"/line number ,"label"/line number , etc. . . 
• •:.: RESUME "label" 
t IF-THEN-ELSE "label" . 
..RUN LABEL "label". 

.' CLS val - Homes the cursor and sets all of video refresh RAM to value of 
... val ( to 255 ). 
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Model 4 & Max-80 BASIC 
Keywords removed from BASIC. 



* • sr • AUTO - USE A 

CLOAD - NOT USED 

' - ,' . CONT - USE C 

I /.- , ■ CSAVE - NOT USED 

'. r ' DELETE - USE D 

. '--I"':-. EDIT - USE E 

.'.'•"• SYSTEM - NOT USED 



- USE REM 



Keywords added to BASIC. 



LABEL LABEL "label" - defines current line as being "label". 

EXIT EXIT line number/"label" - satisfies FOR-NEXT loop without FOR 

I parameter reaching limit. 

SORT SORT var(O) - single dimension array sort, (will add later). 

IND( PRINT IND(n) - prints n spaces from current cursor position, (n « 

- <- . '; •' • to 255) . ...J 

j ERASE ERASE var(O) - removes var array from RAM. (CMD"L"var (0) - vl.6) 

ZERO ZERO var(0) - sets all elements in var array to zero if numeric 

...'." > . or null if string. (CMD"K"var (0) vl.6) 

LPOS : :•.•*. LPOS(0) - returns the position of the printer under software 

| -• control. 

HEX$ HEX$(integar val) - returns a 4 character string equivalent to 

"\ integer val. 

J BIN$ BIN$ (integer val) - returns a 16 character string equivalent to 

| integer val. 

CALL CALL integer val - executes code to located at integer val. . 
WPEEK(integer val) - returns the WORD located at Integer val. 



WPEEK 
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...'••\V'- Model 4 & Max-80 BASIC 

'EXAMPLES of new BASIC commands. " 
PROBLEM: To obtain, the hexadecimal equivalent In a RAM location. 

" OLD 

20 DEFINT A-Z 

30 H$- "0123456789ABCDEF" 

40 X- PEEK(N) 

50 Y- PEEK(N+1) 

60 LI- INT (X/16) 

70 L2- X-L1*16 
■80 Ml- INT (Y/16) 

90 M2- Y-M1*16 
100 A$^ID$(H$,Ml+i,l)+MID$(H$,M2+l,l)+MID$(H$,Ll+l,l)+MID$(H$, L2+1.1) 

NEW ••'■•.•*'•"-•:;..'- 

10 A$«HEX$(WPEEK(N)) 

'-..•" PROBLEM: Prematurely exit a for-next loop. 

old s • ' • ' ;" •' '"■ . '. • 

200 FOR X- 1 TON 

210 IF A$(X)« "MATCH" THEN Y=X:X=N: NEXT: GOTO 400 

220 NEXT X - 

• • • 

400 PRINT A$CY) 

. NEW 

200 FOR X-l TO N 

210 IF A$(X)-"MATCH" THEN EXIT 400 
. ..:.;., . 220 NEXT X 

• • • 

••;•/_; 400 PRINT A$(X) ~ 

<:; ' -.'%••;.": "■'■'.■ ■ " •" •;•">■'.■•'■ ..- -.'■ ''- ' ; '••. 

•,r While programs are being developed, it is easier to use LABEL'S to define 

':- - variou3 routlne3 » than to assign and remember specific line numbers. 

'-.•^ Rules: 1. LABEL must be the first statement in a line. 

V^,;-:' 2. The "label" referenced must match in character length and case. 
;",r. 7 ', 3. Any character other than and 34 Is permitted. 

'.'•"J? J. 60 IF A$-"R"THEN~G0SUB"NEW BOARD" 
;vT. r> .. more program lines 
>l£..A80 LABEL"NEW BOARD" 

■ " n h fi labels ma y be removed after a program is developed via the use of the 
••;..•* command. This command invokes RESOLVE/BOL and replaces references to 
:;•.;. labels with line numbers. The LABEL"label" Is removed from each line. 
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1 
1 
1 
] 
1 
1 
I 



) 



*£H;v'.; 


-'-.i"- : . 


len 




'•" '-V - • . 




'.'''«-'V4 : i -'' 


" - : W . .-. 


char 


-" 7 .5-' # " • . 


'••;,• ' ' 


NOT 



• . J 



Y; 



J 



— . Model 4 & Max-80 BASIC 

PROBLEM: Limit/control an input to a numeric variable. 
OLD: Varies with the iimits of the acceptable input characters. 

NEW: 10 CLEAR 
20 CLS 

30 AC$ - "012345" 

.. menu printed here with 5 options 
. 80 INPUT @ 704,1,95, USING A$, "SELECTION ";S 

. . SYNTAX: •" " ' •': 

• INPUT(a p o8,[nien,char,[N0T][USINGexp$],["prompt ,, ;]varu 

LINEINPUT'^pos, [$) len, char, [NOT] [USING exp$], ["prompt";] var$ 

INPUT Icol, row, [#] len, char, [NOT] [USING exp$], ["prompt";] varu • > 

LINEINPUTIcol.row, [#]len, char, [NOT] [USINGexp$], ["prompt"; ]var$ 

; ; . SYMBOL.^ ;.;. t / ,,.- ; : MEANING ' "" 

• @pos -v. Specifies exactly - In terms of Video Display positions - where 

. VU-7* the INPUT prompt or INPUT field - if no prompt, will begin 
printing. Integer expression between and 1023 (64X16). or 
.■:...'■ and 1919 (80X24). 

Icol, row Specifies exactly which column (col), and which row the INPUT 

prompt or INPUT field - if no prompt, will begin printing. 

. ' Integer expressions between and 63 for "col", and to 15 for 

row' (64X16), or between and 79 for "col", and to 23 for 

:. : v • "row" (80X24). 

' .*. :V'\'.-: ; v", s P ecifles automatic <ENTER> when INPUT field is full. 

•;:. This Is the length of the INPUT field. Integer expression 
> between 1 and 255. 

;- - This is the field character. Integer expression between 1 and 
,, : 255. (These are Video "POKE" values not "PRINT" values). 

■'; Mask reject indicator, (see below) -....' •; 

USING . Mask indicator, (see below) - " ■' - •» 

exp$ String expression representing the mask characters. ' ' '" 

r • - v USING exp$ - Only use characters in exp$. .- , 

; -r NOT USING exp$ » Do not use any characters in exp$. 

"prompt"; The optional prompt message. 

varu Numeric or string variable, or numeric/string variable list. 

var$ A single string variable. 
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BASIC'S CMD"command" FUNCTION 

The function of CMD"coramand" in SUPERBASIC is to execute a /CMD file from 
BASIC then return to BASIC with the resident program intact. The original 
concept (idea) of CMD"command" was provided to the TRS-80 world by the 
author of NEWDOS. Other than MODEL I and MODEL III TRSDOS, the other new 
operating systems provide a quasi-equivalent function with their BASICS. 
The authors of the popular operating systems - DOSPLUS, LDOS, MULTIDOS, and 
NEWDOS/80 - did not talk to each other and did not come close in the method 
the CMD"command" function is invoked. Since we are not experts on the 
other operating systems, we cannot fully describe how their CMD"coramand" 
function works. Although we are registered users of each ' of these 
operating systems, we do not know if they have or will make a change in the 
CMD M command" code. Nevertheless, we will briefly describe the known 
differences in the CMD"command n functions for the MODEL I and MODEL III 
versions of LDOS, DOSPLUS, MULTIDOS, and NEWDOS/80. 

LDOS: The BASIC CMD"command" checks if about 4K of free memory is 
available, then modifies the @ABORT vector (4030H), the @EXIT 
vector (402DH), and the @ERROR vector (4409H) with code to 
- return to LBASIC when LBASIC and the user program is pushed into 
higher memory. Next TOPMEM is modified to one byte less than 
used for LBASIC and the user program storage, then the "command 11 
* is executed. 

The BASIC CMD"command" is executed directly without regard for 
memory usage. Since the BASIC with DOSPLUS resides at 5700H and 
above, this is not a problem with programs that execute in the 
area of 5200H to 56FFH. All of the LIBRARY commands with 
DOSPLUS execute below 5700H. This requires ZERO memory free! 

MULTIDOS: The BASIC CMD M command M checks if about 6K of free memory is 
available, then pushes SUPERBASIC and the user program into 
higher memory, modifies the @EXIT vector (402DH) with code to 
return to SUPERBASIC (in high memory). Next TOPMEM is modified 
to one byte less than used for SUPERBASIC and the user program 
storage, then the "command" is executed. 

NEWDOS/80: The BASIC CMD"coramand" tries to execute the "command" with 
MINI-DOS. If MINI-DOS can execute the "command", then ZERO 
memory is required and execution Is very fast. If MINI-DOS . 
cannot perform the "command", then BASIC checks to see if about 
9K of free memory is available, computes a checksum on the 
memory used by BASIC and the user program, moves the STACK 
POINTER to 70FFH, then executes- the "command". After the . 
"command". is complete, BASIC makes a checksum on the memory used . 
by BASIC and the user program. If the checksum is different, ; 
„ . ... then BASIC performs a re-boot. 

Where there is reference to memory availability, if insufficient memory is 
available, LDOS and NEWDOS/80 will abort with an "Out of memory" error 
message, but MULTIDOS will print "ignored" then continue with the next 
statement. 
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BASIC'S CMD"command M FUNCTION 

In applications where BASIC is requested to load a machine language program 
into high memory, setting HIGH$ (4049H/404AH - MODEL I, or 4411H/4412H - 
MODEL III) prior to entry into BASIC would solve the problem. Since BASIC 
has its own highest memory available pointer and DOS does not need this 
area protected, this request can be honored after the user has entered 
BASIC. 

EXAMPLE: User machine code routine will reside between F014H and FFFFH. 

***** THINKING ***** 

Required: 1) Move the stack pointer out of the way. 

2) POKE BASIC'S high memory pointer. 

3) Reset the balance of the pointers. 

Known: 1) The BASIC high memory pointer is at 40B1H. 

2) The stack pointer will move with CLEARn. 

3) CLEAR resets all pointers. 

The values to POKE will be in two byte form - the least significant digit 
to 40B1H (16561), and the most significant digit to 40B2H (16562). 

Printing &H40B1 gives us 16561. 

Printing &HF014 gives us -4076. 

Printing &HF0 gives us 240. 

Printing &H14-1 gives us 19. 

***** Now that we have gathered our thoughts ***** 

10 CLEAR 4200 ' Greater than 4076 

20 POKE 16561, 19 ' LSD 

30 POKE 16562, 240 ' MSD 

40 CLEAR ' Reset ALL pointers 

When the user exits from BASIC, the DOS HIGH$ will be where It was prior to 
entering BASIC. 
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■ - '■"/£ J: : , •VV," r / V •'" USING MULTIDOS WITH OTHER PROGRAMS 

LAZY WRITER - The "4 + 1" vo»-oi™ «« on u 

on a MnHpi ttt n^o version, an 80 character version that runs 

o°o^ kV ! JI D0S ' wiU not work wlth Model 4 MULTIDOS A fix it 
present in llVl^l^ <*™ications. This problem should no £ 
present in Lazy Writer's purchased after 1/85. If you have a oroblem 

fee y an5 °vo^ u' ^ ^ iter diSk baCk ' * lon * ^th a fe™0 hand Ing 
lee and you'll receive the fixed version in the mail Tf von L • ? 
want to send your disk back, you can order the fix Ty ^ont ' thereat 
an extra charge of $3.00 for the disk. y pnone ' there s 

OTHER 80 CHARACTER PROGRAMS - If you have an 80 character oroeram that 
runs on A MODEL III DOS, it may not work with Model 4 MULTIDOS S 
program may set a bit that switches in the hardware OM 'is 

o the"' /escort "?£} '" fV° £ U 7 ° U t0 ref lect^he^c^dJSiSn 
MinTTnnq y Port that controls the screen and the ROM. Model 4 

A^Ii? ?° eS P rovide an ima e e of the screen port controller at 05AH 
Additional information is available to programmers who need il lo ' 
integrate programs with MULTIDOS. t0 ? '- 
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JF&OM David Welsh 

Subject - 

Wild card DIR feature: 



04/ 2 1 /8S 



In version 1 71 for the Model I, III, 4, and Max-80; the wild card feature 
rl'J? »"" enhanced to provide a "not" feature or a negative wild 

card. If you use a - sign in front the filename to be match, it will not 
show any filenames that match. For example, DIR -*/CMD , will not show 
any files ending in "/CMD". 

MEMDISK on the Model 4 and Max-80 Multidos: 

M^nrc^ ?T U ,f ,?? P^ted, there has been an enhancement to 
f^T^ErS-" 1 t <80/64) Ver8i ° n and the Max-80 version. If you 
h^LJT^ n W ^ n 1 .^ drlVe number ' MEMDISK" will automatically 
become drive and all the system files and BASIC will be copied to it. 

adder r M™DI S r^ BA ,f° ^ lhB , MBMDISK ' *° MEUDISK < S > »"- been 
With «f«/ ^ J C ??l °" ly th ° 8yBtem files to the MEMDISK. 
fhl ukmH ■ ' '' J° U . d °1 l haVe l ° kil1 BASIC and its overlays from 
£°v Sf ,hT. ° r to hSVe en ° Uffh r °° m to <*>*>* in Programs like 
being Tn ^rs£ 8e mem ° ry ° Verlays and W °"W therefore benefit from 

MEMDISK (SYS) or MBMDISK (SYSTEM) can be used instead of MEMDISK 

feaving U H h w!th W ™jOT m or^afLr °a s^sf r6C ° Ver * MBMDISK att * F 
ua MEMDISK (R), which recovers a MEMDISK that ar^a'd yields ts "after^a 

Im^YskZZI 5 * W -, <B t Pl r Se remember that -thfng can rtover 
a MKMVlbK if the computer has been turned off!) 

^^f^J^nro^Tf 01 ^ (OFF > ° r MBMDISK (REIAOVB) can be used 
instead of MEMDISK W . JlffiMDISf (REC) or MJZMDJSIT fUCOWWj can be 
used instead of MEMDISK (R). 

These changes in MEMDISK make the operation of the DOS smoother than 

L^nrcL ^ qUenUy hSVe my di8ked AUT0 to a DO file that sets up "the 
MEMDISK the way I want. The extra boot time pays off in lightening 
fast, quiet operations that can include having data disks in both of my 
two physical drives. J 



Sincerely, 




j 
J 



J 
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Making a ONE VOLUME, DOUBLE-SIDED system diskette 

When we first issued 1.7 Multidos, we said that it could handle a 
dual-sided diskette as one volume. We didn't say that you could make a 
system diskette into a dual-sided, one volume system diskette. Many people 
thought that they could do this by CONFIGing drive 1 to dual-sided, one 
volume and making a BACKUP of the system diskette. But system files have 
to be in certain places on the diskette for the DOS to work correctly and 
BACKUP won't put them there. VFU won't either unless they already exist in 
the directory. 

By popular demand, we have added a program that creates a correct directory 
for a dual-side one volume diskette. This program is called TS/CMD or 
TD/CMD or T3/CMD or T4/CMD or TM/CMD; depending on which version of the DOS 
we are dealing with. By following the instructions below, you can create a 
One Volume, Double-sided system diskette, if you have dual-sided drives. 
This program is only supposed to work with an unaltered BACKUP of the 
MASTER system diskette. 

If you don't have dual-sided drives, you can kill this program from your 
working diskette using VFU. Leave it on your MASTER. Who knows, you might 
want to buy dual-sided drives. 

Read manual before attempting to use these instructions. Everything in 
italics is an example of what you would type after the MULTIDOS prompt. 

The dual-sided SYSTEM diskette created by this procedure becomes the MASTER 
system disk and can be backed up to make more dual-sided, one volume SYSTEM 
disks. 

Procedure for creating a dual-sided, single volume MULTIDOS system diskette 
using the directory skeleton utility: 

MODEL I - Single density, or Double density. 



j 1. Make a backup of the system diskette (single side, single volume). 

2. Config a drive (V=2) sic. that is NOT logical zero. 



CONFIG :1 (V=2) 

:0, Phy = 0, 5" Floppy, double density, 

one sided, one volume, step rate - 30 mS. 

:1, Phy = 1, 5" Floppy, double density, 

two sided, two volume, step rate = 30 mS. 

:2, Phy = 2, 5" Floppy, double density, 

one sided, one volume, step rate = 30 mS. 

:3, Nil 

:4, Nil 

:5, Nil 

:6, Nil 

:7, Nil 

(more) 
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Making a ONE VOLUME, DOUBLE-SIDED system disk 

3 ' lET'th'ri' 16 rVT"! :d ' ' ° f the bBCkUP diske " e in the drive u ^d for 
do^le density^ 6 d6nSlty ^ ' in « le denSity ' ° r d ° uble ^^ *»r 

FORMAT :J* 

4. Config the drive (SI=2). 
CONFIG :1 (SI=2) 

:0, Phy = 0, 5" Floppy, double density, 

one sided, one volume, step rate = 30 mS 
:1, Phy = 1, 5" Floppy, double density, 

two sided, one volume, step rate = 30 mS. 

:3, Nil 
:4, Nil 
:5, Nil 
:6, Nil 
:7, Nil 

5 ' T^TS^o^Tn 81116 ^ dens . i 1 t 1 y ' T ™ for Double d ^-ity on this diskette. 

SYSCFM H \ Pr ° g i rain W , lll 1 aSk f ° r the driVG nUmber of the disk to be 

SYSGENed to one volume dual-sided. 

6. VFU X all files except DIR/SYS and SYSRES/SYS (Use the "0" option) 
Here is an example (the directory of your disk will be different): 

MULTIDOS 
VFU X 
Versatile File Utility - 8.1 (c) C. E. C. 1985 



Press Action 
"C" Copy 
"E" Execute 
"H M Hard copy 
"M" Move 
M P" Purge 

Choice C 



Condition (A/C/D/E/0/S)? O 

Press "S" for selective, or "T" for total T 

Include "INVISIBLE" files? Y 

Include "SYSTEM" files? Y 

Source drive? Destination drive? 1 



(more) 
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Making a ONE VOLUME, DOUBLE-SIDED system diskette 

Drive 
Disk - MULTIDOS - 02/16/84, 29 free grans. 

Allocate/DOL Close/DOL Command/DOL DIR/SYS Debug/DOL 
Error/DOL Help/EXT Libraryl/EXT Library2/EXT Minidos/DOL 
Open/DOL 

Press back arrow to select or "ENTER" if done. - 

Press "A" to abort, "ENTER" to execute, or "R" to repeat. 

Don't forget the % sign after VFU! 
7. ZAP the DCT - TRACK (CYLINDER) 0, SECTOR 6. (see below) 



MODEL III, MODEL 4, and MAX-80 

The procedure for the Model 111,4 and Max-80 is simpler. 

1. Config a drive (SI=2) - NOT logical zero. 

2. Format a diskette in the drive used for step one. 

3. Perform T3 - MODEL III, or T4 - MODEL 4, or TM - MAX-80 on this 
diskette. 

4. VFU % all files except DIR/SYS (Use the "0" option). 

5. ZAP the DCT - TRACK (CYLINDER) 0, SECTOR 6. 

MULTIDOS 

Easy ZAP - Version 2.4 - (c) C. E. C. 1985. 

C = Copy sectors. 

D = Disk sectors. 

F = File sectors. 

M = Memory. 

T = Track format. 

V = Verify. 

X = Fix directory. 

-Choice D 

-Drive number ( to 7 ) 1 

-Cylinder number ( to 255/OFFH ) 

-Sector number ( to 255/OFFH ) 6 



(more) 
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Making a ONE VOLUME, DOUBLE-SIDED system disk 



ZAP 


thi 


HEX 


00 




10 




20 


DRV 


30 


1 


40 




50 




60 


TRK 


70 


000 


80 


00H 


90 




AO 


SEC 


BO 


006 


CO 


06H 


DO 




EO 


STD 


FO 



s byte. Change the 01 to 82. 

» i i 
■ i 

8300 aai oooo 0606 1210 0000 0000 

8301 8211 1100 0606 1210 0000 0000 

8302 8211 1100 06d6 1210 0000 0000 

8303 8211 1100 0606 1210 0000 0000 
OOFF 0000 0000 0000 0000 0000 0000 
OOFF 0000 0000 0000 0000 0000 0000 
OOFF 0000 0000 0000 0000 0000 0000 
OOFF 0000 0000 0000 0000 0000 0000 
0000 0000 0000 0000 CDDC 45E5 D5FD 
CB5F 282E F5FD 6E08 AF67 8230 0124 
F955 6F19 3E12 5FFD CB02 7E28 0187 
0455 BB38 0693 213C 46CB E65F FlCB 
0114 CB57 21ED 37F5 2804 CB22 CB06 
2F77 2C7A 2F77 F1F6 18D1 E1C9 E5C5 
4479 E607 47A9 4F7E 70B8 F521 ED37 
CD83 467E 2FFD 7704 78CD 8346 FD7E 



0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

7E00 

2D20 ._( 

CD78 .Uo 

6720 .U.8 

2C7B ...W 

2123 /w,z/w. 

2811 Dy..G.O~p 

042F ..FV.w.x 



.7 



!<F 



$- 
.x 

g 

,{ 
!# 

7(. 



Press "ENTER" to update, "BREAK" to abort, or "@" to see buffer. 
-Drive number ( to 7 ) 

Typical TRACK 0, SECTOR 6 



i 
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JJSJSm^ M ° DEL l Single Densit y customers. The Single Density version of 

ZTAiTer sTJ d °t le - Si H de K d " fliPP , y disk "- A ^ip^is liie^woSs in 
one and either side can be read by a sinlge sided drive. Just turn it over. 

Both sides contain the operating system, but neither side has a full set of 
utilities Everything that the 1.7 version of MULTIDOS provides „l not fit on 
a Single Density diskette. We suggest you BACKUP both side Re dt, a 
then make up your working disks with only those utilities that you wi 1 be us i 
most. The others can always be used as needed from another disk VH I 
customizing your working disk easy. another disk. VFU makes 



Here is side 1 of the SINGLE DENSITY 1.71 MULTIDOS. 
this are in bold italic: 



Files that only appear on 



1 MULTIDOS 02/11/85 35 log 35 phy cyls 
Filename Date Eof Lrl 



grans 0.00 K 
Lrec Se& Grans 



J 
J 
J 
J 

I 



Allocate/DOL 
BACKUP/CMD I 
BASIC/CMD I 
BBASIC/CMD I 
CAT/CHD P 
COPY/CMD I 
CREF/BOL S 
Close/DOL S 
Command/DOL £ 
DBISIX/CMD 
DDT/CM) 
DIR/SYS S 
Debug/DOL S 
EDIT/BOL S 
ERROR/BOL S 
Error/DOL S 
FORMAT/CMD I 
GR/CMD 
Libraryl/EXT 
Library2/EXT 
MEM/CMD P 
MEMDISK/CMD 
Minidos/DOL S 
Open/DOL S 
PACK/BOL S 
PRT/CMD 
RENUM/BOL S 
RS/CMD P 
SPOOL/CMD 
SYSRES/SYS S 
TAPE/CMD 
UNPACK/BOL S 
UTIL/BOL S 
VFU/CMD P 
ZAP/CMD P 



02/16/85 

02/04/85 

03/30/85 

03/30/85 

02/17/85 

02/17/85 

11/13/84 

01/27/85 

12/27/84 

02/17/85 

07/13/84 

02/11/85 

08/22/84 

05/25/84 

07/07/84 

02/17/85 

02/17/85 

07/25/84 

02/17/85 

02/19/85 

07/13/84 

Ol/U/85 

02/17/85 

01/21/85 

06/30/84 

12/27/84 

11/13/84 

06/30/84 

12/27/84 

02/11/85 

07/13/84 

11/13/84 

02/17/85 

02/17/85 

02/17/85 



3/7 
17/17 
16/25 
22/64 
9/203 
4/255 
4/252 
3/78 
5/0 
2/221 
4/32 
10/0 
4/246 
5/0 
4/210 
4/107 
14/247 

1/3 
21/206 
22/105 
1/195 
3/198 
4/254 
4/144 
4/229 
3/210 
5/0 
4/227 
4/172 
20/0 
7/68 
5/0 
4/176 
17/107 
31/210 



256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 



4 
18 
17 
23 
10 
5 
5 
4 
5 
3 
5 
10 
5 
5 
5 
5 
15 
2 
22 
23 
2 
4 
5 
5 
5 
4 
5 
5 
5 
20 
8 
5 
5 
18 
32 



1 
1 
I 
1 
1 
1 
2 

I 

1 

I 

1 

3 

1 

5 

5 

1 

1 

1 

1 

1 

1 

1 

1 

1 

4 

2 

1 

1 

4 
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Here is side 2 of the MULTIDOS MODEL I SINGLE DENSITY 1.71. Files that onlv 
appear on this are in bold italic: 



1 MULTIDOS 02/11/85 35 log 35 phy cyls 
Filename Date Eof Lrl 



grans 
Lrec Seg 



Allocate/DOL S 
BACKUP/CMD I 
BASIC/CMD I 
BBASIC/CMD 
CDIR/CMD 
COPY/CMD I 
CREF/BOL S 
Close/DOL S 
Command/DOL S 
DIR/SYS S 
Debug/DOL S 
EDIT/BOL S 
ERROR/BOL S 
Error/DOL S 
FMAP/CMD 
FORMAT /CMD I 
HELP/CMD 
LO/CMD 

Libraryl/EXT S 
Library2/EXT S 
Minidos/DOL S 
Open/DOL S 
PACK/BOL S 
RENUM/BOL S 
SYSRES/SYS S 
TS/CMD 
UNPACK/BOL S 
UTIL/BOL S 
VFU/CMD 
ZAP/CMD 



02/16/85 

02/04/85 

03/30/85 

03/30/85 

02/17/85 

02/17/85 

11/13/84 

01/27/85 

12/27/84 

02/11/85 

08/22/84 

05/25/84 

07/07/84 

02/17/85 

02/17/85 

02/17/85 

09/24/84 

11/17/84 

02/17/85 

02/19/85 

02/17/85 

01/21/85 

06/30/84 

11/13/84 

02/11/85 

04/10/85 

11/13/84 

02/17/85 

02/17/85 

02/17/85 



3/7 
17/17 
16/25 
22/64 
2/255 
4/255 
4/252 
3/78 
5/0 
10/0 
4/246 
5/0 
4/210 
4/107 
4/241 
14/247 
23/95 

8/209 
21/206 
22/105 
4/254 
4/144 
4/229 
5/0 
20/0 
11/44 
5/0 
4/176 
17/107 
31/210 



256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 

256 



4 
18 
17 

23 
3 
5 
5 
4 
5 

10 
5 
5 
5 
5 
5 

15 

24 
9 
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SUPERBASIC 
REFERENCE Cross reference variables, and Integers up to 9999999. 

;[p][[//]xxx]<ENTER> 

p = listing directive. if p = "*" the reference listing is to 
the display. If p = "$" the the reference listing is to 
the printer and the display. 
xxx ■ Reference target: 

(1) A one or two character variable name without 
a type suffix. 

(2) An Integer number which may be a line number 
or a value used in the program. 

(3) A key word if preceded by a // symbol. 

Option (1) lists all line numbers which contain the variable specified. 
Option (2) lists all line numbers and other references to the integer 
specified. Option (3) lists all line numbers which contain the key word. 
After a reference target has been established, the reference lines will be 
displayed sequentially, with each additional press of <;> alone. 

If the p option is used with a xxx target, a reference listing will be 
produced starting with the target and proceeding in ascending order. Use of 
the p option without a xxx target, results In a reference listing of all 
integer numbers and variables. If the reference listing Is requested in the 
form ";p*//<ENTER>" , a listing of key words will be produced. The key word 
listing is produced in the order BASIC " tokenizes" (converts to compressed 
storage) the key words. This is not alphabetical order. 

To pause during a reference listing, press shift @. To resume the listing, 
press any key. To abort the reference listing, press <BREAK>. 

EXAMPLES: 

;*<ENTER> 

All Integer and variable references are displayed on the screen. 

;K<ENTER> 

All references to the variable "K" are displayed on the screen. 

;$G<ENTER> 

All variable starting with "G" and continuing through "ZZ" will 
have their references directed to the video and line printer. 

; //PRINT <ENTER> _ . , 

All line numbers which contain the key word "PRINT" will 
. be displayed on the screen. 

;$//<ENTER> 

All key words will have their references directed to the video and 
line printer. 
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